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

package/src/lib/model/contact-record.js

@@ -14,12 +14,12 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */ import * as Aglyn from "@aglyn/aglyn";
+import { crmShareChipFor } from "./crm-sharing.js";
 /*
- * `NO_HOLDER_GROUP` and `contactPrimaryGroup` moved to `@aglyn/aglyn`
- * under AGL-2662 so the server's whole-collection export can flatten a
- * contact the way the organization-level list does — the console app may
- * not import this plugin. Re-exported here, so every caller is unchanged.
- */ export { contactPrimaryGroup, NO_HOLDER_GROUP } from "@aglyn/aglyn";
+ * Which holder a cross-site reader sees one contact through (AGL-2630) —
+ * `contact-holder.ts`, shared with the server's whole-collection export so
+ * the file and the organization-level list flatten a contact one way.
+ */ export { contactPrimaryGroup, NO_HOLDER_GROUP } from "./contact-holder.js";
 /** A document off the wire, flattened through one group's facet. */ export function contactRecordFromDoc(row, group) {
     var _row_$id, _facet_name, _facet_tags, _facet_notes, _facet_ltvCents, _facet_ordersCount, _facet_phone, _facet_jobTitle, _facet_leadSource, _facet_companyName, _facet_companyId, _facet_address, _facet_custom, _facet_mediaIds, _facet_ownerUid;
     const facet = Aglyn.readContactFacet(row, group.groupId);
@@ -37,7 +37,7 @@
         interactions: Aglyn.interactionsForGroup(facet.interactions, group.hostIds),
         tags: (_facet_tags = facet.tags) != null ? _facet_tags : [],
         notes: (_facet_notes = facet.notes) != null ? _facet_notes : '',
-        campaignIds: Aglyn.readContactCampaignIds(row, group.groupId),
+        campaignIds: Aglyn.readContactContainerIds(row, group.groupId, 'campaign'),
         ltvCents: (_facet_ltvCents = facet.ltvCents) != null ? _facet_ltvCents : 0,
         ordersCount: (_facet_ordersCount = facet.ordersCount) != null ? _facet_ordersCount : 0,
         phone: (_facet_phone = facet.phone) != null ? _facet_phone : '',
@@ -54,6 +54,7 @@
         lastEmailEngagementAtMs: typeof facet.lastEmailEngagementAtMs === 'number' && Number.isFinite(facet.lastEmailEngagementAtMs) && facet.lastEmailEngagementAtMs > 0 ? facet.lastEmailEngagementAtMs : null,
         nextTaskAtMs: Aglyn.readNextTaskAtMs(row),
         emailState: Aglyn.readEmailState(row),
+        shareChip: crmShareChipFor(row, group.hostIds),
         createdAt: row['createdAt'],
         updatedAt: row['updatedAt']
     };

package/src/lib/model/contact-record.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/model/contact-record.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 * as Aglyn from '@aglyn/aglyn'\nimport type {\n  AglynPostalAddress,\n  ConsentGroup,\n  ContactInteraction,\n  ContactLifecycleStage,\n  ContactSource,\n} from '@aglyn/aglyn'\n\n/**\n * One contact, as the VIEWING GROUP may see it (AGL-2596).\n *\n * A contact document is shared by every site in the org, and almost nothing\n * on it is legitimately shared: the notes, tags, timeline, profile and\n * commercial figures are the holder's own records and live in that holder's\n * facet. This is the row after the facet read — flat, so the list, the\n * record page and the export can render fields by name without any of them\n * reaching into `facets.{groupId}` for itself. One projection rather than a\n * facet read at every field is what keeps a surface from ever showing\n * another holder's records: there is no field on this shape that came from\n * the top of the document except the two that ARE shared, the address and\n * the canonical name.\n */\nexport interface ContactRecord {\n  $id: string\n  /**\n   * The facet this row was flattened through — the viewing group under a\n   * site, the person's primary holder at the org level (AGL-2630). A write\n   * that edits the row goes back to the same facet, so a surface that has\n   * only the flat record can still address the holder's own fields.\n   */\n  groupId: string\n  /**\n   * A site of that holder's group — the viewing site under a site, and at\n   * the organization level the site the primary holder was resolved from —\n   * which is where a stage move for this row is made and announced. `''` for\n   * a row no site holds.\n   */\n  holderHostId: string\n  /** Every site that has captured this person, sorted — the org-level \"Known by\". */\n  capturedByHostIds: string[]\n  /** The shared identity and the dedupe key. */\n  email: string\n  /** The other addresses a merge folded into this record (AGL-2625). */\n  alternateEmails: string[]\n  /** What THIS holder sees — their own override, or the canonical name. */\n  name: string\n  /** The canonical name: the identity of last resort, shared by every holder. */\n  canonicalName: string\n  /** This holder's own name for the person, when they have set one. */\n  nameOverride: string\n  sources: Partial<Record<ContactSource, true>>\n  /** This holder's timeline, narrowed to the sites the group covers. */\n  interactions: ContactInteraction[]\n  tags: string[]\n  notes: string\n  campaignIds: string[]\n  ltvCents: number\n  ordersCount: number\n  phone: string\n  jobTitle: string\n  /** This holder's lead source label (AGL-3298), `''` for none. */\n  leadSource: string\n  companyName: string\n  companyId: string\n  /**\n   * What linking this person to a company has to know — this holder's link,\n   * the shared mirror and the other holders' ids — so the properties card\n   * and the bulk bar can plan a link from the row without the document. Not\n   * a display field: the mirror is an index every reader of the document\n   * already holds, and nothing renders it.\n   */\n  companyLink: Aglyn.ContactCompanyLinkState\n  address: AglynPostalAddress | null\n  /** This holder's custom field values, keyed by definition key (AGL-2601). */\n  custom?: Record<string, Aglyn.ContactCustomValue>\n  /** This holder's attached org-library files, by media id (AGL-2662). */\n  mediaIds?: string[]\n  ownerUid: string\n  /** Empty when the holder has not placed the person in the funnel. */\n  lifecycleStage: ContactLifecycleStage | ''\n  /**\n   * When the person last opened or clicked one of this holder's campaigns\n   * (AGL-2616), or `null` when they never have since the stamp shipped.\n   */\n  lastEmailEngagementAtMs: number | null\n  /**\n   * When the earliest open task against this person is due (AGL-2661), or\n   * `null` when nothing is scheduled. SHARED, not the holder's: a task is\n   * filed against the contact document, and every holder reading the row\n   * sees the same next step.\n   */\n  nextTaskAtMs: number | null\n  /**\n   * The last verdict on the address (AGL-3245) — bounced, blocked,\n   * unsubscribed, do-not-contact — or `null` when nothing is known. SHARED\n   * like the address it is about.\n   */\n  emailState: Aglyn.EmailState | null\n  createdAt?: unknown\n  updatedAt?: unknown\n}\n\n/*\n * `NO_HOLDER_GROUP` and `contactPrimaryGroup` moved to `@aglyn/aglyn`\n * under AGL-2662 so the server's whole-collection export can flatten a\n * contact the way the organization-level list does — the console app may\n * not import this plugin. Re-exported here, so every caller is unchanged.\n */\nexport { contactPrimaryGroup, NO_HOLDER_GROUP } from '@aglyn/aglyn'\n\n/** A document off the wire, flattened through one group's facet. */\nexport function contactRecordFromDoc(\n  row: Record<string, any>,\n  group: ConsentGroup,\n): ContactRecord {\n  const facet = Aglyn.readContactFacet(row, group.groupId)\n  return {\n    $id: String(row['$id'] ?? ''),\n    groupId: group.groupId,\n    holderHostId: group.hostId,\n    capturedByHostIds: Aglyn.contactCaptureHostIds(row),\n    email: typeof row['email'] === 'string' ? row['email'] : '',\n    alternateEmails: Array.isArray(row[Aglyn.CONTACT_ALTERNATE_EMAILS_FIELD])\n      ? (row[Aglyn.CONTACT_ALTERNATE_EMAILS_FIELD] as unknown[]).filter(\n          (email): email is string => typeof email === 'string',\n        )\n      : [],\n    name: Aglyn.contactDisplayName(row, group.groupId),\n    canonicalName: typeof row['name'] === 'string' ? row['name'] : '',\n    nameOverride: facet.name ?? '',\n    sources: facet.sources,\n    interactions: Aglyn.interactionsForGroup(facet.interactions, group.hostIds),\n    tags: facet.tags ?? [],\n    notes: facet.notes ?? '',\n    campaignIds: Aglyn.readContactCampaignIds(row, group.groupId),\n    ltvCents: facet.ltvCents ?? 0,\n    ordersCount: facet.ordersCount ?? 0,\n    phone: facet.phone ?? '',\n    jobTitle: facet.jobTitle ?? '',\n    leadSource: facet.leadSource ?? '',\n    companyName: facet.companyName ?? '',\n    companyId: facet.companyId ?? '',\n    companyLink: Aglyn.readContactCompanyLink(row, group.groupId),\n    address: facet.address ?? null,\n    custom: facet.custom ?? {},\n    mediaIds: facet.mediaIds ?? [],\n    ownerUid: facet.ownerUid ?? '',\n    lifecycleStage: Aglyn.isContactLifecycleStage(facet.lifecycleStage)\n      ? facet.lifecycleStage\n      : '',\n    lastEmailEngagementAtMs:\n      typeof facet.lastEmailEngagementAtMs === 'number' &&\n      Number.isFinite(facet.lastEmailEngagementAtMs) &&\n      facet.lastEmailEngagementAtMs > 0\n        ? facet.lastEmailEngagementAtMs\n        : null,\n    nextTaskAtMs: Aglyn.readNextTaskAtMs(row as { nextTaskAtMs?: unknown }),\n    emailState: Aglyn.readEmailState(row),\n    createdAt: row['createdAt'],\n    updatedAt: row['updatedAt'],\n  }\n}\n\n/**\n * Tags as typed — comma-separated — into the shape the facet stores:\n * lower-cased, trimmed, deduplicated and capped, so a tag typed on the\n * record page and one typed in the create drawer are the same tag to the\n * segment filter that matches on them.\n */\nexport function parseContactTags(input: string): string[] {\n  return [\n    ...new Set(\n      input\n        .split(',')\n        .map((tag) => tag.trim().toLowerCase().slice(0, 40))\n        .filter(Boolean)\n        .slice(0, 20),\n    ),\n  ]\n}\n"],"names":["Aglyn","contactPrimaryGroup","NO_HOLDER_GROUP","contactRecordFromDoc","row","group","facet","readContactFacet","groupId","$id","String","holderHostId","hostId","capturedByHostIds","contactCaptureHostIds","email","alternateEmails","Array","isArray","CONTACT_ALTERNATE_EMAILS_FIELD","filter","name","contactDisplayName","canonicalName","nameOverride","sources","interactions","interactionsForGroup","hostIds","tags","notes","campaignIds","readContactCampaignIds","ltvCents","ordersCount","phone","jobTitle","leadSource","companyName","companyId","companyLink","readContactCompanyLink","address","custom","mediaIds","ownerUid","lifecycleStage","isContactLifecycleStage","lastEmailEngagementAtMs","Number","isFinite","nextTaskAtMs","readNextTaskAtMs","emailState","readEmailState","createdAt","updatedAt","parseContactTags","input","Set","split","map","tag","trim","toLowerCase","slice","Boolean"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/model/contact-record.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 * as Aglyn from '@aglyn/aglyn'\nimport { type CrmShareChip, crmShareChipFor } from './crm-sharing'\nimport type {\n  AglynPostalAddress,\n  ConsentGroup,\n  ContactInteraction,\n  ContactLifecycleStage,\n  ContactSource,\n} from '@aglyn/aglyn'\n\n/**\n * One contact, as the VIEWING GROUP may see it (AGL-2596).\n *\n * A contact document is shared by every site in the org, and almost nothing\n * on it is legitimately shared: the notes, tags, timeline, profile and\n * commercial figures are the holder's own records and live in that holder's\n * facet. This is the row after the facet read — flat, so the list, the\n * record page and the export can render fields by name without any of them\n * reaching into `facets.{groupId}` for itself. One projection rather than a\n * facet read at every field is what keeps a surface from ever showing\n * another holder's records: there is no field on this shape that came from\n * the top of the document except the two that ARE shared, the address and\n * the canonical name.\n */\nexport interface ContactRecord {\n  $id: string\n  /**\n   * The facet this row was flattened through — the viewing group under a\n   * site, the person's primary holder at the org level (AGL-2630). A write\n   * that edits the row goes back to the same facet, so a surface that has\n   * only the flat record can still address the holder's own fields.\n   */\n  groupId: string\n  /**\n   * A site of that holder's group — the viewing site under a site, and at\n   * the organization level the site the primary holder was resolved from —\n   * which is where a stage move for this row is made and announced. `''` for\n   * a row no site holds.\n   */\n  holderHostId: string\n  /** Every site that has captured this person, sorted — the org-level \"Known by\". */\n  capturedByHostIds: string[]\n  /** The shared identity and the dedupe key. */\n  email: string\n  /** The other addresses a merge folded into this record (AGL-2625). */\n  alternateEmails: string[]\n  /** What THIS holder sees — their own override, or the canonical name. */\n  name: string\n  /** The canonical name: the identity of last resort, shared by every holder. */\n  canonicalName: string\n  /** This holder's own name for the person, when they have set one. */\n  nameOverride: string\n  sources: Partial<Record<ContactSource, true>>\n  /** This holder's timeline, narrowed to the sites the group covers. */\n  interactions: ContactInteraction[]\n  tags: string[]\n  notes: string\n  campaignIds: string[]\n  ltvCents: number\n  ordersCount: number\n  phone: string\n  jobTitle: string\n  /** This holder's lead source label (AGL-3298), `''` for none. */\n  leadSource: string\n  companyName: string\n  companyId: string\n  /**\n   * What linking this person to a company has to know — this holder's link,\n   * the shared mirror and the other holders' ids — so the properties card\n   * and the bulk bar can plan a link from the row without the document. Not\n   * a display field: the mirror is an index every reader of the document\n   * already holds, and nothing renders it.\n   */\n  companyLink: Aglyn.ContactCompanyLinkState\n  address: AglynPostalAddress | null\n  /** This holder's custom field values, keyed by definition key (AGL-2601). */\n  custom?: Record<string, Aglyn.ContactCustomValue>\n  /** This holder's attached org-library files, by media id (AGL-2662). */\n  mediaIds?: string[]\n  ownerUid: string\n  /** Empty when the holder has not placed the person in the funnel. */\n  lifecycleStage: ContactLifecycleStage | ''\n  /**\n   * When the person last opened or clicked one of this holder's campaigns\n   * (AGL-2616), or `null` when they never have since the stamp shipped.\n   */\n  lastEmailEngagementAtMs: number | null\n  /**\n   * When the earliest open task against this person is due (AGL-2661), or\n   * `null` when nothing is scheduled. SHARED, not the holder's: a task is\n   * filed against the contact document, and every holder reading the row\n   * sees the same next step.\n   */\n  nextTaskAtMs: number | null\n  /**\n   * The last verdict on the address (AGL-3245) — bounced, blocked,\n   * unsubscribed, do-not-contact — or `null` when nothing is known. SHARED\n   * like the address it is about.\n   */\n  emailState: Aglyn.EmailState | null\n  /**\n   * Why the viewing group sees this person when the answer is a share\n   * (AGL-3336) — `null` when it holds them, and at the organization level.\n   */\n  shareChip?: CrmShareChip | null\n  createdAt?: unknown\n  updatedAt?: unknown\n}\n\n/*\n * Which holder a cross-site reader sees one contact through (AGL-2630) —\n * `contact-holder.ts`, shared with the server's whole-collection export so\n * the file and the organization-level list flatten a contact one way.\n */\nexport { contactPrimaryGroup, NO_HOLDER_GROUP } from './contact-holder'\n\n/** A document off the wire, flattened through one group's facet. */\nexport function contactRecordFromDoc(\n  row: Record<string, any>,\n  group: ConsentGroup,\n): ContactRecord {\n  const facet = Aglyn.readContactFacet(row, group.groupId)\n  return {\n    $id: String(row['$id'] ?? ''),\n    groupId: group.groupId,\n    holderHostId: group.hostId,\n    capturedByHostIds: Aglyn.contactCaptureHostIds(row),\n    email: typeof row['email'] === 'string' ? row['email'] : '',\n    alternateEmails: Array.isArray(row[Aglyn.CONTACT_ALTERNATE_EMAILS_FIELD])\n      ? (row[Aglyn.CONTACT_ALTERNATE_EMAILS_FIELD] as unknown[]).filter(\n          (email): email is string => typeof email === 'string',\n        )\n      : [],\n    name: Aglyn.contactDisplayName(row, group.groupId),\n    canonicalName: typeof row['name'] === 'string' ? row['name'] : '',\n    nameOverride: facet.name ?? '',\n    sources: facet.sources,\n    interactions: Aglyn.interactionsForGroup(facet.interactions, group.hostIds),\n    tags: facet.tags ?? [],\n    notes: facet.notes ?? '',\n    campaignIds: Aglyn.readContactContainerIds(row, group.groupId, 'campaign'),\n    ltvCents: facet.ltvCents ?? 0,\n    ordersCount: facet.ordersCount ?? 0,\n    phone: facet.phone ?? '',\n    jobTitle: facet.jobTitle ?? '',\n    leadSource: facet.leadSource ?? '',\n    companyName: facet.companyName ?? '',\n    companyId: facet.companyId ?? '',\n    companyLink: Aglyn.readContactCompanyLink(row, group.groupId),\n    address: facet.address ?? null,\n    custom: facet.custom ?? {},\n    mediaIds: facet.mediaIds ?? [],\n    ownerUid: facet.ownerUid ?? '',\n    lifecycleStage: Aglyn.isContactLifecycleStage(facet.lifecycleStage)\n      ? facet.lifecycleStage\n      : '',\n    lastEmailEngagementAtMs:\n      typeof facet.lastEmailEngagementAtMs === 'number' &&\n      Number.isFinite(facet.lastEmailEngagementAtMs) &&\n      facet.lastEmailEngagementAtMs > 0\n        ? facet.lastEmailEngagementAtMs\n        : null,\n    nextTaskAtMs: Aglyn.readNextTaskAtMs(row as { nextTaskAtMs?: unknown }),\n    emailState: Aglyn.readEmailState(row),\n    shareChip: crmShareChipFor(row, group.hostIds),\n    createdAt: row['createdAt'],\n    updatedAt: row['updatedAt'],\n  }\n}\n\n/**\n * Tags as typed — comma-separated — into the shape the facet stores:\n * lower-cased, trimmed, deduplicated and capped, so a tag typed on the\n * record page and one typed in the create drawer are the same tag to the\n * segment filter that matches on them.\n */\nexport function parseContactTags(input: string): string[] {\n  return [\n    ...new Set(\n      input\n        .split(',')\n        .map((tag) => tag.trim().toLowerCase().slice(0, 40))\n        .filter(Boolean)\n        .slice(0, 20),\n    ),\n  ]\n}\n"],"names":["Aglyn","crmShareChipFor","contactPrimaryGroup","NO_HOLDER_GROUP","contactRecordFromDoc","row","group","facet","readContactFacet","groupId","$id","String","holderHostId","hostId","capturedByHostIds","contactCaptureHostIds","email","alternateEmails","Array","isArray","CONTACT_ALTERNATE_EMAILS_FIELD","filter","name","contactDisplayName","canonicalName","nameOverride","sources","interactions","interactionsForGroup","hostIds","tags","notes","campaignIds","readContactContainerIds","ltvCents","ordersCount","phone","jobTitle","leadSource","companyName","companyId","companyLink","readContactCompanyLink","address","custom","mediaIds","ownerUid","lifecycleStage","isContactLifecycleStage","lastEmailEngagementAtMs","Number","isFinite","nextTaskAtMs","readNextTaskAtMs","emailState","readEmailState","shareChip","createdAt","updatedAt","parseContactTags","input","Set","split","map","tag","trim","toLowerCase","slice","Boolean"],"mappings":"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"}

package/src/lib/model/contact-remove.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @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 contract of `crm/contact-remove` (AGL-3338), client-safe: what the
+ * record page's Delete and the contacts bar's Remove send, and what each
+ * contact is answered with.
+ */
+/** The most contacts one request may name — the bar sends a selection in pieces this size. */
+export declare const CRM_CONTACT_REMOVE_MAX = 200;
+export interface ContactRemoveRequest {
+    /** The mounted site; at the organization level the record's own site, or nothing. */
+    hostId?: string | null;
+    /** The organization, which makes the call the route's organization variant. */
+    orgId?: string;
+    contactIds: string[];
+}
+/**
+ * One contact's answer: `detached` when other sites still hold the person
+ * and only this holder's half went, `deleted` when nobody else did and the
+ * document went with it — or refused, with a sentence written for the reader.
+ */
+export type ContactRemoveOutcome = {
+    contactId: string;
+    ok: true;
+    removed: 'detached' | 'deleted';
+} | {
+    contactId: string;
+    ok: false;
+    error: string;
+};
+export interface ContactRemoveResponse {
+    ok: true;
+    results: ContactRemoveOutcome[];
+}

package/src/lib/model/contact-remove.js

@@ -0,0 +1,22 @@
+/**
+ * @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 contract of `crm/contact-remove` (AGL-3338), client-safe: what the
+ * record page's Delete and the contacts bar's Remove send, and what each
+ * contact is answered with.
+ */ /** The most contacts one request may name — the bar sends a selection in pieces this size. */ export const CRM_CONTACT_REMOVE_MAX = 200;
+
+//# sourceMappingURL=contact-remove.js.map

package/src/lib/model/contact-remove.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/model/contact-remove.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * The contract of `crm/contact-remove` (AGL-3338), client-safe: what the\n * record page's Delete and the contacts bar's Remove send, and what each\n * contact is answered with.\n */\n\n/** The most contacts one request may name — the bar sends a selection in pieces this size. */\nexport const CRM_CONTACT_REMOVE_MAX = 200\n\nexport interface ContactRemoveRequest {\n  /** The mounted site; at the organization level the record's own site, or nothing. */\n  hostId?: string | null\n  /** The organization, which makes the call the route's organization variant. */\n  orgId?: string\n  contactIds: string[]\n}\n\n/**\n * One contact's answer: `detached` when other sites still hold the person\n * and only this holder's half went, `deleted` when nobody else did and the\n * document went with it — or refused, with a sentence written for the reader.\n */\nexport type ContactRemoveOutcome =\n  | { contactId: string; ok: true; removed: 'detached' | 'deleted' }\n  | { contactId: string; ok: false; error: string }\n\nexport interface ContactRemoveResponse {\n  ok: true\n  results: ContactRemoveOutcome[]\n}\n"],"names":["CRM_CONTACT_REMOVE_MAX"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;CAIC,GAED,4FAA4F,GAC5F,OAAO,MAAMA,yBAAyB,IAAG"}

package/src/lib/model/contacts-bulk-writes.d.ts

@@ -22,8 +22,7 @@
  * to an owner, file them under a company, move them along the funnel, let
  * them go. A contact's tags, owner and company are one holder's records in
  * that holder's facet, and a facet is the server's to write: the rules cannot
- * tell one field of it from another, so they leave a client nothing there
- * but letting a holder go. So every act but that one is a request to a route,
+ * tell one field of it from another. So every act is a request to a route,
  * and what this module decides is WHICH rows the request names — the bar
  * holds only the controls.
  *
@@ -37,23 +36,8 @@
  * "398 of 400" is a number nobody can act on; an address is. The route asks
  * the same questions of the stored document, so a row that changed since the
  * table read it is still refused by name rather than slipped past.
- *
- * ## Letting go is still written here
- *
- * Removing a contact from a site drops that holder's facet, consent entries,
- * capture attribution and scope tokens — the one change to a facet a holder
- * may make client-direct. Those patches are built here and applied in
- * batches with a per-row fallback, so a refused row is named rather than
- * failing the other 399 with it.
- *
- * Pure apart from the Firestore sentinels the detach carries: the runner takes
- * its writers as ports, so the bar wires `writeBatch`/`updateDoc`/`deleteDoc`
- * in and a spec wires a ledger in.
  */
 import { type ContactCompanyLinkState } from '@aglyn/aglyn';
-import { chunked } from './crm-bulk-writes';
-export declare const CONTACT_BULK_WRITE_CHUNK = 400;
-export { chunked };
 /** The record page's cap on a holder's tags — the same number, so the two agree. */
 export declare const CONTACT_TAGS_CAP = 20;
 /** As much of a table row as a bulk act reads. */
@@ -71,31 +55,16 @@ export interface ContactBulkRow {
     holderHostId?: string;
     /** THIS holder's tags, already read through the facet by the table. */
     tags?: string[];
-    /** The holder tokens — what `planContactDetach` counts. */
+    /** The holder tokens the row is shared with. */
     visibleTo?: string[];
     /** The link state the company planner reads — see `ContactRecord.companyLink`. */
     companyLink?: ContactCompanyLinkState;
 }
-/** One client-direct write to one contact document, named by the address it is about. */
-export type ContactBulkWrite = {
-    id: string;
-    email: string;
-} & ({
-    kind: 'update';
-    data: Record<string, unknown>;
-} | {
-    kind: 'delete';
-});
 /** A row an action deliberately left alone, and why. */
 export interface ContactBulkSkip {
     email: string;
     reason: string;
 }
-/** What a letting-go wants written, and what it declined to. */
-export interface ContactBulkPlan {
-    writes: ContactBulkWrite[];
-    skipped: ContactBulkSkip[];
-}
 /** The rows a request to a route names, and the rows it leaves out by name. */
 export interface ContactBulkSelection {
     rows: ContactBulkRow[];
@@ -133,41 +102,3 @@ export declare function planRemoveTag(rows: readonly ContactBulkRow[], tag: stri
  * request is not the place to guess.
  */
 export declare function planSetCompany(rows: readonly ContactBulkRow[], companyId: string | null): ContactBulkSelection;
-/**
- * Let every row go — the record page's DELETE IS A DETACH, per row.
- *
- * `planContactDetach` decides for each document whether this holder is the
- * last one (delete) or one of several (drop this group's facet, consent
- * entries, capture attribution and scope tokens). The `arrayRemove` and
- * `deleteField` sentinels are the ones the record page writes, so a row
- * detached here and a row detached there are the same document afterwards.
- *
- * ⛔ Not the erasure path: a privacy erasure removes the person everywhere
- * regardless of holders.
- */
-export declare function planDetach(rows: readonly ContactBulkRow[], group: {
-    groupId: string;
-    hostIds: readonly string[];
-}, nowMs: number): ContactBulkPlan;
-/** The writers the runner needs — Firestore's, or a spec's ledger. */
-export interface ContactBulkWriters {
-    /** Apply every write atomically, or throw. */
-    commitBatch: (writes: readonly ContactBulkWrite[]) => Promise<void>;
-    /** Apply one write, or throw. */
-    commitOne: (write: ContactBulkWrite) => Promise<void>;
-}
-export interface ContactBulkOutcome {
-    /** Rows written. */
-    done: number;
-    /** Rows the store refused, by address, with the reason it gave. */
-    refused: Array<{
-        email: string;
-        error: string;
-    }>;
-}
-/**
- * The shared runner over contact writes — batched, with a per-row pass for
- * the chunk that failed (`crm-bulk-writes.ts`) — reporting by ADDRESS, which
- * is the name a contacts report lists a row under.
- */
-export declare function runContactBulkWrites(writers: ContactBulkWriters, writes: readonly ContactBulkWrite[], chunkSize?: number): Promise<ContactBulkOutcome>;

package/src/lib/model/contacts-bulk-writes.js

@@ -1,4 +1,3 @@
-import { _ as _extends } from "@swc/helpers/_/_extends";
 /**
  * @license
  * Copyright 2026 Aglyn LLC
@@ -22,8 +21,7 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
  * to an owner, file them under a company, move them along the funnel, let
  * them go. A contact's tags, owner and company are one holder's records in
  * that holder's facet, and a facet is the server's to write: the rules cannot
- * tell one field of it from another, so they leave a client nothing there
- * but letting a holder go. So every act but that one is a request to a route,
+ * tell one field of it from another. So every act is a request to a route,
  * and what this module decides is WHICH rows the request names — the bar
  * holds only the controls.
  *
@@ -37,27 +35,7 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
  * "398 of 400" is a number nobody can act on; an address is. The route asks
  * the same questions of the stored document, so a row that changed since the
  * table read it is still refused by name rather than slipped past.
- *
- * ## Letting go is still written here
- *
- * Removing a contact from a site drops that holder's facet, consent entries,
- * capture attribution and scope tokens — the one change to a facet a holder
- * may make client-direct. Those patches are built here and applied in
- * batches with a per-row fallback, so a refused row is named rather than
- * failing the other 399 with it.
- *
- * Pure apart from the Firestore sentinels the detach carries: the runner takes
- * its writers as ports, so the bar wires `writeBatch`/`updateDoc`/`deleteDoc`
- * in and a spec wires a ledger in.
- */ import { planContactCompanyLink, planContactDetach } from "@aglyn/aglyn";
-import { arrayRemove, deleteField } from "firebase/firestore";
-import { CRM_BULK_WRITE_CHUNK, chunked, runCrmBulkWrites } from "./crm-bulk-writes.js";
-/*
- * The runner and its chunk size are the shared ones (`crm-bulk-writes.ts`,
- * AGL-2621), under the names this module has always exported: the batch
- * cap and the per-row fallback are about Firestore, not about people.
- */ export const CONTACT_BULK_WRITE_CHUNK = CRM_BULK_WRITE_CHUNK;
-export { chunked };
+ */ import { planContactCompanyLink } from "@aglyn/aglyn";
 /** The record page's cap on a holder's tags — the same number, so the two agree. */ export const CONTACT_TAGS_CAP = 20;
 /** The address a report names a row by, falling back to the id. */ export const contactBulkAddressOf = (row)=>String(row.email || row.$id);
 /**
@@ -134,63 +112,5 @@ export { chunked };
         skipped
     };
 }
-/**
- * Let every row go — the record page's DELETE IS A DETACH, per row.
- *
- * `planContactDetach` decides for each document whether this holder is the
- * last one (delete) or one of several (drop this group's facet, consent
- * entries, capture attribution and scope tokens). The `arrayRemove` and
- * `deleteField` sentinels are the ones the record page writes, so a row
- * detached here and a row detached there are the same document afterwards.
- *
- * ⛔ Not the erasure path: a privacy erasure removes the person everywhere
- * regardless of holders.
- */ export function planDetach(rows, group, nowMs) {
-    return {
-        writes: rows.map((row)=>{
-            var _row_visibleTo;
-            // Only the holder tokens reach the plan: that is all it reads, and a
-            // projected table row carries fields the detach must not consult.
-            const plan = planContactDetach({
-                visibleTo: (_row_visibleTo = row.visibleTo) != null ? _row_visibleTo : []
-            }, group);
-            if (plan.action === 'delete') {
-                return {
-                    id: row.$id,
-                    email: contactBulkAddressOf(row),
-                    kind: 'delete'
-                };
-            }
-            return {
-                id: row.$id,
-                email: contactBulkAddressOf(row),
-                kind: 'update',
-                data: _extends({}, Object.fromEntries(plan.remove.map((path)=>[
-                        path,
-                        deleteField()
-                    ])), {
-                    visibleTo: arrayRemove(...plan.removeTokens),
-                    capturedByHostIds: arrayRemove(...plan.removeHostIds),
-                    updatedAt: new Date(nowMs)
-                })
-            };
-        }),
-        skipped: []
-    };
-}
-/**
- * The shared runner over contact writes — batched, with a per-row pass for
- * the chunk that failed (`crm-bulk-writes.ts`) — reporting by ADDRESS, which
- * is the name a contacts report lists a row under.
- */ export async function runContactBulkWrites(writers, writes, chunkSize = CONTACT_BULK_WRITE_CHUNK) {
-    const outcome = await runCrmBulkWrites(writers, writes, (write)=>write.email, chunkSize);
-    return {
-        done: outcome.done,
-        refused: outcome.refused.map((row)=>({
-                email: row.label,
-                error: row.error
-            }))
-    };
-}
 
 //# sourceMappingURL=contacts-bulk-writes.js.map

package/src/lib/model/contacts-bulk-writes.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/model/contacts-bulk-writes.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 * What a bulk action on the contacts table does to each row (AGL-2603, and\n * through the server since AGL-2804).\n *\n * The bar over the table offers one act over many rows — tag them, hand them\n * to an owner, file them under a company, move them along the funnel, let\n * them go. A contact's tags, owner and company are one holder's records in\n * that holder's facet, and a facet is the server's to write: the rules cannot\n * tell one field of it from another, so they leave a client nothing there\n * but letting a holder go. So every act but that one is a request to a route,\n * and what this module decides is WHICH rows the request names — the bar\n * holds only the controls.\n *\n * ## A row with nothing to change is left out, and a row that cannot be\n * ## reached is REPORTED\n *\n * A row already carrying the tag, or already at the company, is left out of\n * the request silently: the route would write nothing, and a report saying\n * so would be noise. A row already at the tag cap, or whose company link the\n * table could not project, is left out and named by address — a count of\n * \"398 of 400\" is a number nobody can act on; an address is. The route asks\n * the same questions of the stored document, so a row that changed since the\n * table read it is still refused by name rather than slipped past.\n *\n * ## Letting go is still written here\n *\n * Removing a contact from a site drops that holder's facet, consent entries,\n * capture attribution and scope tokens — the one change to a facet a holder\n * may make client-direct. Those patches are built here and applied in\n * batches with a per-row fallback, so a refused row is named rather than\n * failing the other 399 with it.\n *\n * Pure apart from the Firestore sentinels the detach carries: the runner takes\n * its writers as ports, so the bar wires `writeBatch`/`updateDoc`/`deleteDoc`\n * in and a spec wires a ledger in.\n */\n\nimport {\n  type ContactCompanyLinkState,\n  planContactCompanyLink,\n  planContactDetach,\n} from '@aglyn/aglyn'\nimport { arrayRemove, deleteField } from 'firebase/firestore'\nimport {\n  CRM_BULK_WRITE_CHUNK,\n  chunked,\n  runCrmBulkWrites,\n} from './crm-bulk-writes'\n\n/*\n * The runner and its chunk size are the shared ones (`crm-bulk-writes.ts`,\n * AGL-2621), under the names this module has always exported: the batch\n * cap and the per-row fallback are about Firestore, not about people.\n */\nexport const CONTACT_BULK_WRITE_CHUNK = CRM_BULK_WRITE_CHUNK\nexport { chunked }\n\n/** The record page's cap on a holder's tags — the same number, so the two agree. */\nexport const CONTACT_TAGS_CAP = 20\n\n/** As much of a table row as a bulk act reads. */\nexport interface ContactBulkRow {\n  $id: string\n  email?: string\n  /**\n   * The holder this row was flattened through (`ContactRecord.groupId`),\n   * which a cross-holder reader — the organization-level list (AGL-2630) —\n   * writes each row through, since no one viewing group covers every\n   * selected person there.\n   */\n  groupId?: string\n  /** A site of that holder's group — where the row's stage is moved (`ContactRecord.holderHostId`). */\n  holderHostId?: string\n  /** THIS holder's tags, already read through the facet by the table. */\n  tags?: string[]\n  /** The holder tokens — what `planContactDetach` counts. */\n  visibleTo?: string[]\n  /** The link state the company planner reads — see `ContactRecord.companyLink`. */\n  companyLink?: ContactCompanyLinkState\n}\n\n/** One client-direct write to one contact document, named by the address it is about. */\nexport type ContactBulkWrite = { id: string; email: string } & (\n  | { kind: 'update'; data: Record<string, unknown> }\n  | { kind: 'delete' }\n)\n\n/** A row an action deliberately left alone, and why. */\nexport interface ContactBulkSkip {\n  email: string\n  reason: string\n}\n\n/** What a letting-go wants written, and what it declined to. */\nexport interface ContactBulkPlan {\n  writes: ContactBulkWrite[]\n  skipped: ContactBulkSkip[]\n}\n\n/** The rows a request to a route names, and the rows it leaves out by name. */\nexport interface ContactBulkSelection {\n  rows: ContactBulkRow[]\n  skipped: ContactBulkSkip[]\n}\n\n/** The address a report names a row by, falling back to the id. */\nexport const contactBulkAddressOf = (row: ContactBulkRow): string =>\n  String(row.email || row.$id)\n\n/**\n * A typed tag as the record page stores one, or `null` when nothing survives.\n *\n * Lowercased and trimmed because the record page lowercases and trims, and\n * `contactMatchesSegment` compares lowercased — a bulk \"VIP\" beside a typed\n * \"vip\" would otherwise be two tags on one list and one filter finding half\n * of them.\n */\nexport function normalizeBulkTag(input: string): string | null {\n  const tag = input.trim().toLowerCase().slice(0, 60)\n  return tag || null\n}\n\n/**\n * The rows adding one tag reaches.\n *\n * A row that already carries the tag is left out silently. A row already at\n * the cap without it is left out AND reported: the cap is the record page's,\n * and a bulk path that slipped past it would leave a tag the page's next\n * save silently drops.\n */\nexport function planAddTag(\n  rows: readonly ContactBulkRow[],\n  tag: string,\n): ContactBulkSelection {\n  const reached: ContactBulkRow[] = []\n  const skipped: ContactBulkSkip[] = []\n  for (const row of rows) {\n    const held = (row.tags ?? []).map((held) => held.toLowerCase())\n    if (held.includes(tag)) continue\n    if (held.length >= CONTACT_TAGS_CAP) {\n      skipped.push({\n        email: contactBulkAddressOf(row),\n        reason: `already has ${CONTACT_TAGS_CAP} tags`,\n      })\n      continue\n    }\n    reached.push(row)\n  }\n  return { rows: reached, skipped }\n}\n\n/** The rows taking one tag off reaches: the ones that carry it. */\nexport function planRemoveTag(\n  rows: readonly ContactBulkRow[],\n  tag: string,\n): ContactBulkSelection {\n  return {\n    rows: rows.filter((row) =>\n      (row.tags ?? []).map((held) => held.toLowerCase()).includes(tag),\n    ),\n    skipped: [],\n  }\n}\n\n/**\n * The rows filing under one company reaches — or unlinking, with `null`\n * (AGL-2613).\n *\n * A row already where it was asked to be is left out silently, as a row\n * already tagged is. A row the table could not project a link state for is\n * left out AND named: whether its link would change cannot be told, and the\n * request is not the place to guess.\n */\nexport function planSetCompany(\n  rows: readonly ContactBulkRow[],\n  companyId: string | null,\n): ContactBulkSelection {\n  const reached: ContactBulkRow[] = []\n  const skipped: ContactBulkSkip[] = []\n  for (const row of rows) {\n    if (!row.companyLink) {\n      skipped.push({\n        email: contactBulkAddressOf(row),\n        reason: 'its company link could not be read',\n      })\n      continue\n    }\n    if (planContactCompanyLink(row.companyLink, companyId)) reached.push(row)\n  }\n  return { rows: reached, skipped }\n}\n\n/**\n * Let every row go — the record page's DELETE IS A DETACH, per row.\n *\n * `planContactDetach` decides for each document whether this holder is the\n * last one (delete) or one of several (drop this group's facet, consent\n * entries, capture attribution and scope tokens). The `arrayRemove` and\n * `deleteField` sentinels are the ones the record page writes, so a row\n * detached here and a row detached there are the same document afterwards.\n *\n * ⛔ Not the erasure path: a privacy erasure removes the person everywhere\n * regardless of holders.\n */\nexport function planDetach(\n  rows: readonly ContactBulkRow[],\n  group: { groupId: string; hostIds: readonly string[] },\n  nowMs: number,\n): ContactBulkPlan {\n  return {\n    writes: rows.map((row) => {\n      // Only the holder tokens reach the plan: that is all it reads, and a\n      // projected table row carries fields the detach must not consult.\n      const plan = planContactDetach({ visibleTo: row.visibleTo ?? [] }, group)\n      if (plan.action === 'delete') {\n        return { id: row.$id, email: contactBulkAddressOf(row), kind: 'delete' as const }\n      }\n      return {\n        id: row.$id,\n        email: contactBulkAddressOf(row),\n        kind: 'update' as const,\n        data: {\n          ...Object.fromEntries(plan.remove.map((path) => [path, deleteField()])),\n          visibleTo: arrayRemove(...plan.removeTokens),\n          capturedByHostIds: arrayRemove(...plan.removeHostIds),\n          updatedAt: new Date(nowMs),\n        },\n      }\n    }),\n    skipped: [],\n  }\n}\n\n/** The writers the runner needs — Firestore's, or a spec's ledger. */\nexport interface ContactBulkWriters {\n  /** Apply every write atomically, or throw. */\n  commitBatch: (writes: readonly ContactBulkWrite[]) => Promise<void>\n  /** Apply one write, or throw. */\n  commitOne: (write: ContactBulkWrite) => Promise<void>\n}\n\nexport interface ContactBulkOutcome {\n  /** Rows written. */\n  done: number\n  /** Rows the store refused, by address, with the reason it gave. */\n  refused: Array<{ email: string; error: string }>\n}\n\n/**\n * The shared runner over contact writes — batched, with a per-row pass for\n * the chunk that failed (`crm-bulk-writes.ts`) — reporting by ADDRESS, which\n * is the name a contacts report lists a row under.\n */\nexport async function runContactBulkWrites(\n  writers: ContactBulkWriters,\n  writes: readonly ContactBulkWrite[],\n  chunkSize: number = CONTACT_BULK_WRITE_CHUNK,\n): Promise<ContactBulkOutcome> {\n  const outcome = await runCrmBulkWrites(\n    writers,\n    writes,\n    (write) => write.email,\n    chunkSize,\n  )\n  return {\n    done: outcome.done,\n    refused: outcome.refused.map((row) => ({ email: row.label, error: row.error })),\n  }\n}\n"],"names":["planContactCompanyLink","planContactDetach","arrayRemove","deleteField","CRM_BULK_WRITE_CHUNK","chunked","runCrmBulkWrites","CONTACT_BULK_WRITE_CHUNK","CONTACT_TAGS_CAP","contactBulkAddressOf","row","String","email","$id","normalizeBulkTag","input","tag","trim","toLowerCase","slice","planAddTag","rows","reached","skipped","held","tags","map","includes","length","push","reason","planRemoveTag","filter","planSetCompany","companyId","companyLink","planDetach","group","nowMs","writes","plan","visibleTo","action","id","kind","data","Object","fromEntries","remove","path","removeTokens","capturedByHostIds","removeHostIds","updatedAt","Date","runContactBulkWrites","writers","chunkSize","outcome","write","done","refused","label","error"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/model/contacts-bulk-writes.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 * What a bulk action on the contacts table does to each row (AGL-2603, and\n * through the server since AGL-2804).\n *\n * The bar over the table offers one act over many rows — tag them, hand them\n * to an owner, file them under a company, move them along the funnel, let\n * them go. A contact's tags, owner and company are one holder's records in\n * that holder's facet, and a facet is the server's to write: the rules cannot\n * tell one field of it from another. So every act is a request to a route,\n * and what this module decides is WHICH rows the request names — the bar\n * holds only the controls.\n *\n * ## A row with nothing to change is left out, and a row that cannot be\n * ## reached is REPORTED\n *\n * A row already carrying the tag, or already at the company, is left out of\n * the request silently: the route would write nothing, and a report saying\n * so would be noise. A row already at the tag cap, or whose company link the\n * table could not project, is left out and named by address — a count of\n * \"398 of 400\" is a number nobody can act on; an address is. The route asks\n * the same questions of the stored document, so a row that changed since the\n * table read it is still refused by name rather than slipped past.\n */\n\nimport {\n  type ContactCompanyLinkState,\n  planContactCompanyLink,\n} from '@aglyn/aglyn'\n\n/** The record page's cap on a holder's tags — the same number, so the two agree. */\nexport const CONTACT_TAGS_CAP = 20\n\n/** As much of a table row as a bulk act reads. */\nexport interface ContactBulkRow {\n  $id: string\n  email?: string\n  /**\n   * The holder this row was flattened through (`ContactRecord.groupId`),\n   * which a cross-holder reader — the organization-level list (AGL-2630) —\n   * writes each row through, since no one viewing group covers every\n   * selected person there.\n   */\n  groupId?: string\n  /** A site of that holder's group — where the row's stage is moved (`ContactRecord.holderHostId`). */\n  holderHostId?: string\n  /** THIS holder's tags, already read through the facet by the table. */\n  tags?: string[]\n  /** The holder tokens the row is shared with. */\n  visibleTo?: string[]\n  /** The link state the company planner reads — see `ContactRecord.companyLink`. */\n  companyLink?: ContactCompanyLinkState\n}\n\n/** A row an action deliberately left alone, and why. */\nexport interface ContactBulkSkip {\n  email: string\n  reason: string\n}\n\n/** The rows a request to a route names, and the rows it leaves out by name. */\nexport interface ContactBulkSelection {\n  rows: ContactBulkRow[]\n  skipped: ContactBulkSkip[]\n}\n\n/** The address a report names a row by, falling back to the id. */\nexport const contactBulkAddressOf = (row: ContactBulkRow): string =>\n  String(row.email || row.$id)\n\n/**\n * A typed tag as the record page stores one, or `null` when nothing survives.\n *\n * Lowercased and trimmed because the record page lowercases and trims, and\n * `contactMatchesSegment` compares lowercased — a bulk \"VIP\" beside a typed\n * \"vip\" would otherwise be two tags on one list and one filter finding half\n * of them.\n */\nexport function normalizeBulkTag(input: string): string | null {\n  const tag = input.trim().toLowerCase().slice(0, 60)\n  return tag || null\n}\n\n/**\n * The rows adding one tag reaches.\n *\n * A row that already carries the tag is left out silently. A row already at\n * the cap without it is left out AND reported: the cap is the record page's,\n * and a bulk path that slipped past it would leave a tag the page's next\n * save silently drops.\n */\nexport function planAddTag(\n  rows: readonly ContactBulkRow[],\n  tag: string,\n): ContactBulkSelection {\n  const reached: ContactBulkRow[] = []\n  const skipped: ContactBulkSkip[] = []\n  for (const row of rows) {\n    const held = (row.tags ?? []).map((held) => held.toLowerCase())\n    if (held.includes(tag)) continue\n    if (held.length >= CONTACT_TAGS_CAP) {\n      skipped.push({\n        email: contactBulkAddressOf(row),\n        reason: `already has ${CONTACT_TAGS_CAP} tags`,\n      })\n      continue\n    }\n    reached.push(row)\n  }\n  return { rows: reached, skipped }\n}\n\n/** The rows taking one tag off reaches: the ones that carry it. */\nexport function planRemoveTag(\n  rows: readonly ContactBulkRow[],\n  tag: string,\n): ContactBulkSelection {\n  return {\n    rows: rows.filter((row) =>\n      (row.tags ?? []).map((held) => held.toLowerCase()).includes(tag),\n    ),\n    skipped: [],\n  }\n}\n\n/**\n * The rows filing under one company reaches — or unlinking, with `null`\n * (AGL-2613).\n *\n * A row already where it was asked to be is left out silently, as a row\n * already tagged is. A row the table could not project a link state for is\n * left out AND named: whether its link would change cannot be told, and the\n * request is not the place to guess.\n */\nexport function planSetCompany(\n  rows: readonly ContactBulkRow[],\n  companyId: string | null,\n): ContactBulkSelection {\n  const reached: ContactBulkRow[] = []\n  const skipped: ContactBulkSkip[] = []\n  for (const row of rows) {\n    if (!row.companyLink) {\n      skipped.push({\n        email: contactBulkAddressOf(row),\n        reason: 'its company link could not be read',\n      })\n      continue\n    }\n    if (planContactCompanyLink(row.companyLink, companyId)) reached.push(row)\n  }\n  return { rows: reached, skipped }\n}\n"],"names":["planContactCompanyLink","CONTACT_TAGS_CAP","contactBulkAddressOf","row","String","email","$id","normalizeBulkTag","input","tag","trim","toLowerCase","slice","planAddTag","rows","reached","skipped","held","tags","map","includes","length","push","reason","planRemoveTag","filter","planSetCompany","companyId","companyLink"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;;;;;;;;;;;;CAsBC,GAED,SAEEA,sBAAsB,QACjB,eAAc;AAErB,kFAAkF,GAClF,OAAO,MAAMC,mBAAmB,GAAE;AAmClC,iEAAiE,GACjE,OAAO,MAAMC,uBAAuB,CAACC,MACnCC,OAAOD,IAAIE,KAAK,IAAIF,IAAIG,GAAG,EAAC;AAE9B;;;;;;;CAOC,GACD,OAAO,SAASC,iBAAiBC,KAAa;IAC5C,MAAMC,MAAMD,MAAME,IAAI,GAAGC,WAAW,GAAGC,KAAK,CAAC,GAAG;IAChD,OAAOH,OAAO;AAChB;AAEA;;;;;;;CAOC,GACD,OAAO,SAASI,WACdC,IAA+B,EAC/BL,GAAW;IAEX,MAAMM,UAA4B,EAAE;IACpC,MAAMC,UAA6B,EAAE;IACrC,KAAK,MAAMb,OAAOW,KAAM;YACRX;QAAd,MAAMc,OAAO,EAACd,YAAAA,IAAIe,IAAI,YAARf,YAAY,EAAE,EAAEgB,GAAG,CAAC,CAACF,OAASA,KAAKN,WAAW;QAC5D,IAAIM,KAAKG,QAAQ,CAACX,MAAM;QACxB,IAAIQ,KAAKI,MAAM,IAAIpB,kBAAkB;YACnCe,QAAQM,IAAI,CAAC;gBACXjB,OAAOH,qBAAqBC;gBAC5BoB,QAAQ,CAAC,YAAY,EAAEtB,iBAAiB,KAAK,CAAC;YAChD;YACA;QACF;QACAc,QAAQO,IAAI,CAACnB;IACf;IACA,OAAO;QAAEW,MAAMC;QAASC;IAAQ;AAClC;AAEA,iEAAiE,GACjE,OAAO,SAASQ,cACdV,IAA+B,EAC/BL,GAAW;IAEX,OAAO;QACLK,MAAMA,KAAKW,MAAM,CAAC,CAACtB;gBAChBA;mBAAD,EAACA,YAAAA,IAAIe,IAAI,YAARf,YAAY,EAAE,EAAEgB,GAAG,CAAC,CAACF,OAASA,KAAKN,WAAW,IAAIS,QAAQ,CAACX;;QAE9DO,SAAS,EAAE;IACb;AACF;AAEA;;;;;;;;CAQC,GACD,OAAO,SAASU,eACdZ,IAA+B,EAC/Ba,SAAwB;IAExB,MAAMZ,UAA4B,EAAE;IACpC,MAAMC,UAA6B,EAAE;IACrC,KAAK,MAAMb,OAAOW,KAAM;QACtB,IAAI,CAACX,IAAIyB,WAAW,EAAE;YACpBZ,QAAQM,IAAI,CAAC;gBACXjB,OAAOH,qBAAqBC;gBAC5BoB,QAAQ;YACV;YACA;QACF;QACA,IAAIvB,uBAAuBG,IAAIyB,WAAW,EAAED,YAAYZ,QAAQO,IAAI,CAACnB;IACvE;IACA,OAAO;QAAEW,MAAMC;QAASC;IAAQ;AAClC"}

package/src/lib/model/contacts-csv.d.ts

@@ -37,8 +37,8 @@
  * written, because they are what a merchant reads the file for; they map to
  * "Do not import" on the way back.
  */
-export { CONTACT_CSV_COLUMNS, contactCsvHeader, contactsCsv, type ContactCsvOptions, type ContactCsvRow, } from '@aglyn/aglyn';
-import { type ContactCsvOptions } from '@aglyn/aglyn';
+export { CONTACT_CSV_COLUMNS, contactCsvHeader, contactsCsv, type ContactCsvOptions, type ContactCsvRow, } from './crm-csv';
+import { type ContactCsvOptions } from './crm-csv';
 /**
  * The file the Import drawer hands out to start from: the export's header
  * and nothing under it, so a sheet filled in against it maps itself.

package/src/lib/model/contacts-csv.js

@@ -35,8 +35,8 @@
  * the last interaction and the last campaign engagement — are still
  * written, because they are what a merchant reads the file for; they map to
  * "Do not import" on the way back.
- */ /* The writer moved to `@aglyn/aglyn` under AGL-2662 — see `deals-csv.ts`. */ export { CONTACT_CSV_COLUMNS, contactCsvHeader, contactsCsv } from "@aglyn/aglyn";
-import { contactsCsv } from "@aglyn/aglyn";
+ */ /* The writer is `crm-csv.ts`, shared with the server's export — see `deals-csv.ts`. */ export { CONTACT_CSV_COLUMNS, contactCsvHeader, contactsCsv } from "./crm-csv.js";
+import { contactsCsv } from "./crm-csv.js";
 /**
  * The file the Import drawer hands out to start from: the export's header
  * and nothing under it, so a sheet filled in against it maps itself.

package/src/lib/model/contacts-csv.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/model/contacts-csv.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * The contacts CSV — every CRM column, the same file from the table's\n * Export button and the bulk bar's (AGL-2603, widened by AGL-2621).\n *\n * The selection's export and the table's export are the same file over a\n * different set of rows: the same columns in the same order, the same `|`\n * between multi-valued cells, the same quoting. A second column list would\n * be a second file format for one feature, and the person opening both in\n * a spreadsheet would be the one to find the difference.\n *\n * ## The header row is the import's own vocabulary\n *\n * Each column is headed by a name `guessContactImportMapping` recognizes —\n * \"Job title\", \"Address line 1\", \"Lifecycle stage\", a custom field's label\n * — so an export re-imports without a hand mapping, and the template the\n * Import drawer offers IS this header over no rows. The owner column\n * carries the member's ADDRESS rather than a uid for the same reason: the\n * import resolves an owner by email, and a uid is nothing a spreadsheet\n * can read anyway. The three columns the import has no field for — sources,\n * the last interaction and the last campaign engagement — are still\n * written, because they are what a merchant reads the file for; they map to\n * \"Do not import\" on the way back.\n */\n\n/* The writer moved to `@aglyn/aglyn` under AGL-2662 — see `deals-csv.ts`. */\nexport {\n  CONTACT_CSV_COLUMNS,\n  contactCsvHeader,\n  contactsCsv,\n  type ContactCsvOptions,\n  type ContactCsvRow,\n} from '@aglyn/aglyn'\n\nimport { contactsCsv, type ContactCsvOptions } from '@aglyn/aglyn'\n\n/**\n * The file the Import drawer hands out to start from: the export's header\n * and nothing under it, so a sheet filled in against it maps itself.\n */\nexport function contactImportTemplateCsv(\n  customFields: ContactCsvOptions['customFields'] = [],\n): string {\n  return contactsCsv([], { customFields })\n}\n\n/**\n * Hand the browser a file to save.\n *\n * The one writer that stayed: it touches `URL.createObjectURL` and\n * `document`, so it belongs to the browser and not to the library a server\n * route imports.\n */\nexport function downloadTextFile(name: string, mime: string, text: string): void {\n  const url = URL.createObjectURL(new Blob([text], { type: mime }))\n  const anchor = document.createElement('a')\n  anchor.href = url\n  anchor.download = name\n  anchor.click()\n  URL.revokeObjectURL(url)\n}\n"],"names":["CONTACT_CSV_COLUMNS","contactCsvHeader","contactsCsv","contactImportTemplateCsv","customFields","downloadTextFile","name","mime","text","url","URL","createObjectURL","Blob","type","anchor","document","createElement","href","download","click","revokeObjectURL"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;;;;;;;;;;;;CAsBC,GAED,2EAA2E,GAC3E,SACEA,mBAAmB,EACnBC,gBAAgB,EAChBC,WAAW,QAGN,eAAc;AAErB,SAASA,WAAW,QAAgC,eAAc;AAElE;;;CAGC,GACD,OAAO,SAASC,yBACdC,eAAkD,EAAE;IAEpD,OAAOF,YAAY,EAAE,EAAE;QAAEE;IAAa;AACxC;AAEA;;;;;;CAMC,GACD,OAAO,SAASC,iBAAiBC,IAAY,EAAEC,IAAY,EAAEC,IAAY;IACvE,MAAMC,MAAMC,IAAIC,eAAe,CAAC,IAAIC,KAAK;QAACJ;KAAK,EAAE;QAAEK,MAAMN;IAAK;IAC9D,MAAMO,SAASC,SAASC,aAAa,CAAC;IACtCF,OAAOG,IAAI,GAAGR;IACdK,OAAOI,QAAQ,GAAGZ;IAClBQ,OAAOK,KAAK;IACZT,IAAIU,eAAe,CAACX;AACtB"}
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/model/contacts-csv.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * The contacts CSV — every CRM column, the same file from the table's\n * Export button and the bulk bar's (AGL-2603, widened by AGL-2621).\n *\n * The selection's export and the table's export are the same file over a\n * different set of rows: the same columns in the same order, the same `|`\n * between multi-valued cells, the same quoting. A second column list would\n * be a second file format for one feature, and the person opening both in\n * a spreadsheet would be the one to find the difference.\n *\n * ## The header row is the import's own vocabulary\n *\n * Each column is headed by a name `guessContactImportMapping` recognizes —\n * \"Job title\", \"Address line 1\", \"Lifecycle stage\", a custom field's label\n * — so an export re-imports without a hand mapping, and the template the\n * Import drawer offers IS this header over no rows. The owner column\n * carries the member's ADDRESS rather than a uid for the same reason: the\n * import resolves an owner by email, and a uid is nothing a spreadsheet\n * can read anyway. The three columns the import has no field for — sources,\n * the last interaction and the last campaign engagement — are still\n * written, because they are what a merchant reads the file for; they map to\n * \"Do not import\" on the way back.\n */\n\n/* The writer is `crm-csv.ts`, shared with the server's export — see `deals-csv.ts`. */\nexport {\n  CONTACT_CSV_COLUMNS,\n  contactCsvHeader,\n  contactsCsv,\n  type ContactCsvOptions,\n  type ContactCsvRow,\n} from './crm-csv'\n\nimport { contactsCsv, type ContactCsvOptions } from './crm-csv'\n\n/**\n * The file the Import drawer hands out to start from: the export's header\n * and nothing under it, so a sheet filled in against it maps itself.\n */\nexport function contactImportTemplateCsv(\n  customFields: ContactCsvOptions['customFields'] = [],\n): string {\n  return contactsCsv([], { customFields })\n}\n\n/**\n * Hand the browser a file to save.\n *\n * The one writer that stayed: it touches `URL.createObjectURL` and\n * `document`, so it belongs to the browser and not to the library a server\n * route imports.\n */\nexport function downloadTextFile(name: string, mime: string, text: string): void {\n  const url = URL.createObjectURL(new Blob([text], { type: mime }))\n  const anchor = document.createElement('a')\n  anchor.href = url\n  anchor.download = name\n  anchor.click()\n  URL.revokeObjectURL(url)\n}\n"],"names":["CONTACT_CSV_COLUMNS","contactCsvHeader","contactsCsv","contactImportTemplateCsv","customFields","downloadTextFile","name","mime","text","url","URL","createObjectURL","Blob","type","anchor","document","createElement","href","download","click","revokeObjectURL"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;;;;;;;;;;;;CAsBC,GAED,qFAAqF,GACrF,SACEA,mBAAmB,EACnBC,gBAAgB,EAChBC,WAAW,QAGN,eAAW;AAElB,SAASA,WAAW,QAAgC,eAAW;AAE/D;;;CAGC,GACD,OAAO,SAASC,yBACdC,eAAkD,EAAE;IAEpD,OAAOF,YAAY,EAAE,EAAE;QAAEE;IAAa;AACxC;AAEA;;;;;;CAMC,GACD,OAAO,SAASC,iBAAiBC,IAAY,EAAEC,IAAY,EAAEC,IAAY;IACvE,MAAMC,MAAMC,IAAIC,eAAe,CAAC,IAAIC,KAAK;QAACJ;KAAK,EAAE;QAAEK,MAAMN;IAAK;IAC9D,MAAMO,SAASC,SAASC,aAAa,CAAC;IACtCF,OAAOG,IAAI,GAAGR;IACdK,OAAOI,QAAQ,GAAGZ;IAClBQ,OAAOK,KAAK;IACZT,IAAIU,eAAe,CAACX;AACtB"}