@aglyn/aglyn 1.0.0-beta.218 → 1.0.0-beta.220

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

@@ -1,180 +0,0 @@
-/**
- * @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 NO LONGER EXCLUDED (AGL-3275). It was, by the type rather than a
- * runtime check, because a lead's id is a person key — the same on every site
- * that met the person — while `hosts/{hostId}/leads` was host-scoped by path,
- * so two sites held two documents carrying one id and an org-level address
- * had to name the site to tell them apart. One org collection makes the
- * person key unambiguous, so a lead addresses like every other record.
- */ export function crmOrgRecordHref(orgSlug, kind, id) {
-    return `${crmOrgSectionHref(orgSlug, CRM_RECORD_SECTIONS[kind])}/${encodeURIComponent(id)}`;
-}
-// `crmOrgLeadHref` is gone with the host-path fallback (AGL-3277). It took a
-// site it had already stopped using; `crmOrgRecordHref(orgSlug, 'lead', id)`
-// is the whole of what it did.
-/**
- * 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

@@ -1 +0,0 @@
-{"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 NO LONGER EXCLUDED (AGL-3275). It was, by the type rather than a\n * runtime check, because a lead's id is a person key — the same on every site\n * that met the person — while `hosts/{hostId}/leads` was host-scoped by path,\n * so two sites held two documents carrying one id and an org-level address\n * had to name the site to tell them apart. One org collection makes the\n * person key unambiguous, so a lead addresses like every other record.\n */\nexport function crmOrgRecordHref(\n  orgSlug: string,\n  kind: CrmRecordKind,\n  id: string,\n): string {\n  return `${crmOrgSectionHref(orgSlug, CRM_RECORD_SECTIONS[kind])}/${encodeURIComponent(id)}`\n}\n\n// `crmOrgLeadHref` is gone with the host-path fallback (AGL-3277). It took a\n// site it had already stopped using; `crmOrgRecordHref(orgSlug, 'lead', id)`\n// is the whole of what it did.\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","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":"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"}

package/src/lib/app-utils/contact-holder.d.ts

@@ -1,68 +0,0 @@
-/**
- * @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 ConsentGroup } from './consent-groups';
-/**
- * The holder of nothing: the group a contact is flattened through when no
- * site has captured it and no facet exists — a row written by a path that
- * predates attribution, read at the org level (AGL-2630).
- *
- * An empty `groupId` reads an empty facet (`readContactFacet` answers the
- * empty facet for a key the map lacks) and REFUSES a write
- * (`contactFacetPath` throws on an empty holder), which is the right pair:
- * the row still shows its shared identity, and nothing edits a facet
- * nobody holds. Exported so a surface can test for it rather than for an
- * empty string.
- */
-export declare const NO_HOLDER_GROUP: ConsentGroup;
-/**
- * The group a LEAD is read and acted on through (AGL-3278).
- *
- * The same question {@link contactPrimaryGroup} answers, with a shorter
- * answer: a lead is one flat document — no facets, one profile, one
- * status — so there is nothing to choose between and the holder is simply
- * the site that captured the person first. What it is FOR is the same: at
- * the organization level the record page has no viewing site, and it needs
- * one to read the consent basis against, to file an activity under, to
- * offer a booking on and to convert as.
- *
- * A lead no site has captured — a row imported before attribution — reads
- * through {@link NO_HOLDER_GROUP}, whose empty `hostId` is how a surface
- * asks "is there a site here at all" without testing for an empty string.
- */
-export declare function leadPrimaryGroup(lead: Record<string, unknown> | null | undefined, org: Record<string, unknown> | null | undefined): ConsentGroup;
-/**
- * The group a CROSS-HOLDER reader flattens one contact through (AGL-2630).
- *
- * Under a site there is one answer for every row — the site's own group,
- * `consentGroupForHost` — and the reader never asks this. At the
- * organization level there is no viewing site, and a contact captured by
- * three sites has up to three facets; the org-wide member reading them all
- * needs ONE to show the row's profile, owner and stage under, and to write
- * an edit back to. This picks the person's PRIMARY holder: the first
- * capturing site, in capture order, whose group actually holds a facet;
- * then any facet at all, resolved back to its declared group or to the
- * site whose id it is keyed by; then the first capturing site even with no
- * facet yet (the facet is written on the first edit). A row nobody captured
- * and nobody wrote a facet for reads through {@link NO_HOLDER_GROUP}.
- *
- * Capture order rather than sorted order, deliberately: `capturedByHostIds`
- * is maintained by `arrayUnion`, so its first entry is the site that met
- * the person first, and that site's profile is the one a person reading
- * across brands would expect to see. `contactCaptureHostIds` sorts the same
- * array for RENDERING, where a stable order matters more than a first.
- */
-export declare function contactPrimaryGroup(row: Record<string, unknown> | null | undefined, org: Record<string, unknown> | null | undefined): ConsentGroup;

package/src/lib/app-utils/contact-holder.js

@@ -1,129 +0,0 @@
-/**
- * @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.
- */ /**
- * WHICH HOLDER A CROSS-SITE READER SEES A CONTACT THROUGH (AGL-2630).
- *
- * A contact document carries one facet per holder, and every field but the
- * shared identity lives in one of them. A surface standing on a site reads
- * that site's group; a surface standing at the organization — the org-level
- * Contacts list, and the whole-collection export that writes the same file
- * — has no site to read as and needs one answer per row.
- *
- * In the library rather than in the CRM plugin because both of those
- * readers need it and one of them is an app: an app may not import a
- * feature plugin (AGL-2662).
- */ import { CONTACT_FACETS_FIELD } from "./contacts.js";
-import { CAPTURED_BY_HOST_FIELD } from "./marketing-consent.js";
-import { consentGroupForHost, consentGroupsAwaitConfirmation, readConsentGroups, soloConsentGroup } from "./consent-groups.js";
-/**
- * The holder of nothing: the group a contact is flattened through when no
- * site has captured it and no facet exists — a row written by a path that
- * predates attribution, read at the org level (AGL-2630).
- *
- * An empty `groupId` reads an empty facet (`readContactFacet` answers the
- * empty facet for a key the map lacks) and REFUSES a write
- * (`contactFacetPath` throws on an empty holder), which is the right pair:
- * the row still shows its shared identity, and nothing edits a facet
- * nobody holds. Exported so a surface can test for it rather than for an
- * empty string.
- */ export const NO_HOLDER_GROUP = Object.freeze({
-    hostId: '',
-    groupId: '',
-    name: null,
-    hostIds: [],
-    declared: false,
-    awaitsConfirmation: false
-});
-/**
- * The sites that captured this person, in CAPTURE order — the order
- * `arrayUnion` left, so the first entry is the site that met them first.
- *
- * `contactCaptureHostIds` sorts the same array for RENDERING, where a
- * stable order matters more than a first. Both readers below want the
- * first, so neither may use the sorted one.
- */ function captureOrder(record) {
-    const raw = (record != null ? record : {})[CAPTURED_BY_HOST_FIELD];
-    if (!Array.isArray(raw)) return [];
-    return raw.map((id)=>String(id != null ? id : '').trim()).filter(Boolean);
-}
-/**
- * The group a LEAD is read and acted on through (AGL-3278).
- *
- * The same question {@link contactPrimaryGroup} answers, with a shorter
- * answer: a lead is one flat document — no facets, one profile, one
- * status — so there is nothing to choose between and the holder is simply
- * the site that captured the person first. What it is FOR is the same: at
- * the organization level the record page has no viewing site, and it needs
- * one to read the consent basis against, to file an activity under, to
- * offer a booking on and to convert as.
- *
- * A lead no site has captured — a row imported before attribution — reads
- * through {@link NO_HOLDER_GROUP}, whose empty `hostId` is how a surface
- * asks "is there a site here at all" without testing for an empty string.
- */ export function leadPrimaryGroup(lead, org) {
-    const captured = captureOrder(lead);
-    return captured.length ? consentGroupForHost(org, captured[0]) : NO_HOLDER_GROUP;
-}
-/**
- * The group a CROSS-HOLDER reader flattens one contact through (AGL-2630).
- *
- * Under a site there is one answer for every row — the site's own group,
- * `consentGroupForHost` — and the reader never asks this. At the
- * organization level there is no viewing site, and a contact captured by
- * three sites has up to three facets; the org-wide member reading them all
- * needs ONE to show the row's profile, owner and stage under, and to write
- * an edit back to. This picks the person's PRIMARY holder: the first
- * capturing site, in capture order, whose group actually holds a facet;
- * then any facet at all, resolved back to its declared group or to the
- * site whose id it is keyed by; then the first capturing site even with no
- * facet yet (the facet is written on the first edit). A row nobody captured
- * and nobody wrote a facet for reads through {@link NO_HOLDER_GROUP}.
- *
- * Capture order rather than sorted order, deliberately: `capturedByHostIds`
- * is maintained by `arrayUnion`, so its first entry is the site that met
- * the person first, and that site's profile is the one a person reading
- * across brands would expect to see. `contactCaptureHostIds` sorts the same
- * array for RENDERING, where a stable order matters more than a first.
- */ export function contactPrimaryGroup(row, org) {
-    const record = row != null ? row : {};
-    const facets = record[CONTACT_FACETS_FIELD];
-    const facetKeys = facets && typeof facets === 'object' && !Array.isArray(facets) ? Object.keys(facets) : [];
-    const captured = captureOrder(record);
-    for (const hostId of captured){
-        const group = consentGroupForHost(org, hostId);
-        if (facetKeys.includes(group.groupId)) return group;
-    }
-    for (const key of facetKeys){
-        const declared = readConsentGroups(org)[key];
-        if (declared) {
-            return {
-                hostId: declared.hostIds[0],
-                groupId: key,
-                name: declared.name,
-                hostIds: [
-                    ...declared.hostIds
-                ],
-                declared: true,
-                awaitsConfirmation: consentGroupsAwaitConfirmation(org)
-            };
-        }
-        return soloConsentGroup(key);
-    }
-    if (captured.length) return consentGroupForHost(org, captured[0]);
-    return NO_HOLDER_GROUP;
-}
-
-//# sourceMappingURL=contact-holder.js.map

package/src/lib/app-utils/contact-holder.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/contact-holder.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 * WHICH HOLDER A CROSS-SITE READER SEES A CONTACT THROUGH (AGL-2630).\n *\n * A contact document carries one facet per holder, and every field but the\n * shared identity lives in one of them. A surface standing on a site reads\n * that site's group; a surface standing at the organization — the org-level\n * Contacts list, and the whole-collection export that writes the same file\n * — has no site to read as and needs one answer per row.\n *\n * In the library rather than in the CRM plugin because both of those\n * readers need it and one of them is an app: an app may not import a\n * feature plugin (AGL-2662).\n */\n\nimport { CONTACT_FACETS_FIELD } from './contacts'\nimport { CAPTURED_BY_HOST_FIELD } from './marketing-consent'\nimport {\n  type ConsentGroup,\n  consentGroupForHost,\n  consentGroupsAwaitConfirmation,\n  readConsentGroups,\n  soloConsentGroup,\n} from './consent-groups'\n\n/**\n * The holder of nothing: the group a contact is flattened through when no\n * site has captured it and no facet exists — a row written by a path that\n * predates attribution, read at the org level (AGL-2630).\n *\n * An empty `groupId` reads an empty facet (`readContactFacet` answers the\n * empty facet for a key the map lacks) and REFUSES a write\n * (`contactFacetPath` throws on an empty holder), which is the right pair:\n * the row still shows its shared identity, and nothing edits a facet\n * nobody holds. Exported so a surface can test for it rather than for an\n * empty string.\n */\nexport const NO_HOLDER_GROUP: ConsentGroup = Object.freeze({\n  hostId: '',\n  groupId: '',\n  name: null,\n  hostIds: [],\n  declared: false,\n  awaitsConfirmation: false,\n}) as ConsentGroup\n\n/**\n * The sites that captured this person, in CAPTURE order — the order\n * `arrayUnion` left, so the first entry is the site that met them first.\n *\n * `contactCaptureHostIds` sorts the same array for RENDERING, where a\n * stable order matters more than a first. Both readers below want the\n * first, so neither may use the sorted one.\n */\nfunction captureOrder(\n  record: Record<string, unknown> | null | undefined,\n): string[] {\n  const raw = (record ?? {})[CAPTURED_BY_HOST_FIELD]\n  if (!Array.isArray(raw)) return []\n  return raw.map((id) => String(id ?? '').trim()).filter(Boolean)\n}\n\n/**\n * The group a LEAD is read and acted on through (AGL-3278).\n *\n * The same question {@link contactPrimaryGroup} answers, with a shorter\n * answer: a lead is one flat document — no facets, one profile, one\n * status — so there is nothing to choose between and the holder is simply\n * the site that captured the person first. What it is FOR is the same: at\n * the organization level the record page has no viewing site, and it needs\n * one to read the consent basis against, to file an activity under, to\n * offer a booking on and to convert as.\n *\n * A lead no site has captured — a row imported before attribution — reads\n * through {@link NO_HOLDER_GROUP}, whose empty `hostId` is how a surface\n * asks \"is there a site here at all\" without testing for an empty string.\n */\nexport function leadPrimaryGroup(\n  lead: Record<string, unknown> | null | undefined,\n  org: Record<string, unknown> | null | undefined,\n): ConsentGroup {\n  const captured = captureOrder(lead)\n  return captured.length ? consentGroupForHost(org, captured[0]) : NO_HOLDER_GROUP\n}\n\n/**\n * The group a CROSS-HOLDER reader flattens one contact through (AGL-2630).\n *\n * Under a site there is one answer for every row — the site's own group,\n * `consentGroupForHost` — and the reader never asks this. At the\n * organization level there is no viewing site, and a contact captured by\n * three sites has up to three facets; the org-wide member reading them all\n * needs ONE to show the row's profile, owner and stage under, and to write\n * an edit back to. This picks the person's PRIMARY holder: the first\n * capturing site, in capture order, whose group actually holds a facet;\n * then any facet at all, resolved back to its declared group or to the\n * site whose id it is keyed by; then the first capturing site even with no\n * facet yet (the facet is written on the first edit). A row nobody captured\n * and nobody wrote a facet for reads through {@link NO_HOLDER_GROUP}.\n *\n * Capture order rather than sorted order, deliberately: `capturedByHostIds`\n * is maintained by `arrayUnion`, so its first entry is the site that met\n * the person first, and that site's profile is the one a person reading\n * across brands would expect to see. `contactCaptureHostIds` sorts the same\n * array for RENDERING, where a stable order matters more than a first.\n */\nexport function contactPrimaryGroup(\n  row: Record<string, unknown> | null | undefined,\n  org: Record<string, unknown> | null | undefined,\n): ConsentGroup {\n  const record = row ?? {}\n  const facets = record[CONTACT_FACETS_FIELD]\n  const facetKeys =\n    facets && typeof facets === 'object' && !Array.isArray(facets)\n      ? Object.keys(facets as Record<string, unknown>)\n      : []\n  const captured = captureOrder(record)\n  for (const hostId of captured) {\n    const group = consentGroupForHost(org, hostId)\n    if (facetKeys.includes(group.groupId)) return group\n  }\n  for (const key of facetKeys) {\n    const declared = readConsentGroups(org)[key]\n    if (declared) {\n      return {\n        hostId: declared.hostIds[0],\n        groupId: key,\n        name: declared.name,\n        hostIds: [...declared.hostIds],\n        declared: true,\n        awaitsConfirmation: consentGroupsAwaitConfirmation(org),\n      }\n    }\n    return soloConsentGroup(key)\n  }\n  if (captured.length) return consentGroupForHost(org, captured[0])\n  return NO_HOLDER_GROUP\n}"],"names":["CONTACT_FACETS_FIELD","CAPTURED_BY_HOST_FIELD","consentGroupForHost","consentGroupsAwaitConfirmation","readConsentGroups","soloConsentGroup","NO_HOLDER_GROUP","Object","freeze","hostId","groupId","name","hostIds","declared","awaitsConfirmation","captureOrder","record","raw","Array","isArray","map","id","String","trim","filter","Boolean","leadPrimaryGroup","lead","org","captured","length","contactPrimaryGroup","row","facets","facetKeys","keys","group","includes","key"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;;CAYC,GAED,SAASA,oBAAoB,QAAQ,gBAAY;AACjD,SAASC,sBAAsB,QAAQ,yBAAqB;AAC5D,SAEEC,mBAAmB,EACnBC,8BAA8B,EAC9BC,iBAAiB,EACjBC,gBAAgB,QACX,sBAAkB;AAEzB;;;;;;;;;;;CAWC,GACD,OAAO,MAAMC,kBAAgCC,OAAOC,MAAM,CAAC;IACzDC,QAAQ;IACRC,SAAS;IACTC,MAAM;IACNC,SAAS,EAAE;IACXC,UAAU;IACVC,oBAAoB;AACtB,GAAkB;AAElB;;;;;;;CAOC,GACD,SAASC,aACPC,MAAkD;IAElD,MAAMC,MAAM,CAACD,iBAAAA,SAAU,CAAC,EAAE,CAACf,uBAAuB;IAClD,IAAI,CAACiB,MAAMC,OAAO,CAACF,MAAM,OAAO,EAAE;IAClC,OAAOA,IAAIG,GAAG,CAAC,CAACC,KAAOC,OAAOD,aAAAA,KAAM,IAAIE,IAAI,IAAIC,MAAM,CAACC;AACzD;AAEA;;;;;;;;;;;;;;CAcC,GACD,OAAO,SAASC,iBACdC,IAAgD,EAChDC,GAA+C;IAE/C,MAAMC,WAAWd,aAAaY;IAC9B,OAAOE,SAASC,MAAM,GAAG5B,oBAAoB0B,KAAKC,QAAQ,CAAC,EAAE,IAAIvB;AACnE;AAEA;;;;;;;;;;;;;;;;;;;;CAoBC,GACD,OAAO,SAASyB,oBACdC,GAA+C,EAC/CJ,GAA+C;IAE/C,MAAMZ,SAASgB,cAAAA,MAAO,CAAC;IACvB,MAAMC,SAASjB,MAAM,CAAChB,qBAAqB;IAC3C,MAAMkC,YACJD,UAAU,OAAOA,WAAW,YAAY,CAACf,MAAMC,OAAO,CAACc,UACnD1B,OAAO4B,IAAI,CAACF,UACZ,EAAE;IACR,MAAMJ,WAAWd,aAAaC;IAC9B,KAAK,MAAMP,UAAUoB,SAAU;QAC7B,MAAMO,QAAQlC,oBAAoB0B,KAAKnB;QACvC,IAAIyB,UAAUG,QAAQ,CAACD,MAAM1B,OAAO,GAAG,OAAO0B;IAChD;IACA,KAAK,MAAME,OAAOJ,UAAW;QAC3B,MAAMrB,WAAWT,kBAAkBwB,IAAI,CAACU,IAAI;QAC5C,IAAIzB,UAAU;YACZ,OAAO;gBACLJ,QAAQI,SAASD,OAAO,CAAC,EAAE;gBAC3BF,SAAS4B;gBACT3B,MAAME,SAASF,IAAI;gBACnBC,SAAS;uBAAIC,SAASD,OAAO;iBAAC;gBAC9BC,UAAU;gBACVC,oBAAoBX,+BAA+ByB;YACrD;QACF;QACA,OAAOvB,iBAAiBiC;IAC1B;IACA,IAAIT,SAASC,MAAM,EAAE,OAAO5B,oBAAoB0B,KAAKC,QAAQ,CAAC,EAAE;IAChE,OAAOvB;AACT"}

package/src/lib/app-utils/contact-merge.d.ts

@@ -1,136 +0,0 @@
-/**
- * @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.
- */
-/**
- * MERGING TWO CONTACT DOCUMENTS INTO ONE (AGL-2625) — the pure half.
- *
- * Contacts are keyed by email, so exact duplicates cannot exist; one human
- * with `jane@acme.com` and `jane@gmail.com` is two documents, with tags,
- * deals, tasks and a timeline split between them. A merge folds the second
- * into the first: the SURVIVOR keeps its address as the identity, the MERGED
- * record's address becomes an alternate on it, and every field is combined
- * by one rule the dialog can show before the write happens.
- *
- * ## The rule
- *
- *  - A scalar — a name, a phone, a title, a stage, an owner — is the
- *    survivor's where the survivor has one, and fills from the merged record
- *    where the survivor is empty. Nothing the survivor holds is overwritten.
- *  - A list — tags, campaign filings, the timeline, the sites that captured
- *    the person, the forms, the companies — is the UNION, deduplicated and
- *    bounded where the write paths bound it.
- *  - A figure that counts something — orders, lifetime value, refunds — is
- *    the SUM: two records of one person's purchases are one person's
- *    purchases. A "first" is the earlier, a "last" is the later.
- *  - Notes are appended, survivor first: a note is a list of sentences, and
- *    dropping the merged record's would be the one silent loss in a merge
- *    that is otherwise lossless.
- *  - A recorded REFUSAL of marketing mail on either record stands on the
- *    survivor. The merge asserts the two are one person, and that person
- *    said no.
- *
- * Applied per holder: each group's facet on the merged record is folded
- * into the same group's facet on the survivor, and a group only the merged
- * record had comes across whole. No holder's records reach another holder's
- * facet, which is the guarantee the facet shape exists for.
- *
- * ## Why this is a plan and not a write
- *
- * The console shows the two records side by side and says which value wins
- * before anything is committed; the server performs the write. Both read
- * this function, so the preview cannot show one outcome and the write land
- * another. The plan is plain values — no sentinels — so it can be rendered,
- * and it is shaped for a merge-`set`, which deep-merges the facet map one
- * holder at a time and replaces an array whole: exactly the two behaviors
- * the rule above needs.
- */
-import { type ContactInteraction } from './contacts';
-export interface ContactMergePlan {
-    /**
-     * What the survivor becomes, as a merge-`set` payload: every derived
-     * field with its full value, and only the groups the merged record held
-     * under `facets`. Plain values throughout — the writer adds its own
-     * `updatedAt`.
-     */
-    survivor: Record<string, unknown>;
-    /** Every address the survivor answers to afterwards, primary first. */
-    emails: string[];
-    /** The merged record's addresses — what its leads and index entries are keyed by. */
-    mergedEmails: string[];
-    /**
-     * The companies that lose a contact: those BOTH records were filed under,
-     * which counted two people and now count one. A company only one record
-     * named keeps its count — the survivor still names it.
-     */
-    companyCounts: Array<{
-        companyId: string;
-        delta: -1;
-    }>;
-    /** The union of both records' scope tokens — who may read the survivor. */
-    visibleTo: string[];
-}
-type Doc = Record<string, unknown>;
-/**
- * Both timelines as one: deduplicated by event, newest first, and capped
- * the way every capture caps it — so a merge of two full timelines keeps
- * the fifty most recent visits rather than growing the document past what
- * a capture may write.
- */
-export declare function mergeInteractions(survivor: readonly ContactInteraction[] | undefined, merged: readonly ContactInteraction[] | undefined): ContactInteraction[];
-/**
- * One holder's facet after the merge.
- *
- * `survivor` is that holder's facet on the surviving record — possibly
- * absent, when only the merged record was held by this group — and `merged`
- * the same holder's facet on the record being folded in.
- */
-export declare function mergeContactFacet(survivor: Doc | undefined, merged: Doc | undefined): Doc;
-/**
- * The plan for folding `merged` into `survivor`.
- *
- * Both are the stored documents as read. The survivor's `email` is the
- * identity that stands; the merged record's becomes an alternate.
- */
-export declare function planContactMerge(survivor: Doc, merged: Doc): ContactMergePlan;
-/** Where a previewed value comes from. */
-export type ContactMergeSource = 'survivor' | 'merged' | 'both' | 'none';
-/** One line of the side-by-side the dialog shows. */
-export interface ContactMergePreviewRow {
-    key: string;
-    label: string;
-    /** The surviving record's value, as text. */
-    survivor: string;
-    /** The merged record's value, as text. */
-    merged: string;
-    /** What the survivor carries afterwards. */
-    result: string;
-    from: ContactMergeSource;
-}
-export interface ContactMergePreviewOptions {
-    /** The owner's display name for a uid; the uid itself when absent. */
-    memberName?: (uid: string) => string;
-}
-/**
- * The merge as the viewing group would see it, field by field.
- *
- * Reads through ONE group's facet, the way the record page does, so a
- * holder previewing a merge sees its own values and never another holder's.
- * Every row carries the survivor's value, the merged record's, and the
- * result the plan would write, so the dialog is a rendering and not a second
- * opinion.
- */
-export declare function contactMergePreview(survivor: Doc, merged: Doc, groupId: string, options?: ContactMergePreviewOptions): ContactMergePreviewRow[];
-export {};