@aglyn/plugins-crm 1.0.0-beta.143

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

@@ -0,0 +1,173 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * What a bulk action on the contacts table does to each row (AGL-2603, and
+ * through the server since AGL-2804).
+ *
+ * The bar over the table offers one act over many rows — tag them, hand them
+ * 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,
+ * and what this module decides is WHICH rows the request names — the bar
+ * holds only the controls.
+ *
+ * ## A row with nothing to change is left out, and a row that cannot be
+ * ## reached is REPORTED
+ *
+ * A row already carrying the tag, or already at the company, is left out of
+ * the request silently: the route would write nothing, and a report saying
+ * so would be noise. A row already at the tag cap, or whose company link the
+ * table could not project, is left out and named by address — a count of
+ * "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. */
+export interface ContactBulkRow {
+    $id: string;
+    email?: string;
+    /**
+     * The holder this row was flattened through (`ContactRecord.groupId`),
+     * which a cross-holder reader — the organization-level list (AGL-2630) —
+     * writes each row through, since no one viewing group covers every
+     * selected person there.
+     */
+    groupId?: string;
+    /** A site of that holder's group — where the row's stage is moved (`ContactRecord.holderHostId`). */
+    holderHostId?: string;
+    /** THIS holder's tags, already read through the facet by the table. */
+    tags?: string[];
+    /** The holder tokens — what `planContactDetach` counts. */
+    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[];
+    skipped: ContactBulkSkip[];
+}
+/** The address a report names a row by, falling back to the id. */
+export declare const contactBulkAddressOf: (row: ContactBulkRow) => string;
+/**
+ * A typed tag as the record page stores one, or `null` when nothing survives.
+ *
+ * Lowercased and trimmed because the record page lowercases and trims, and
+ * `contactMatchesSegment` compares lowercased — a bulk "VIP" beside a typed
+ * "vip" would otherwise be two tags on one list and one filter finding half
+ * of them.
+ */
+export declare function normalizeBulkTag(input: string): string | null;
+/**
+ * The rows adding one tag reaches.
+ *
+ * A row that already carries the tag is left out silently. A row already at
+ * the cap without it is left out AND reported: the cap is the record page's,
+ * and a bulk path that slipped past it would leave a tag the page's next
+ * save silently drops.
+ */
+export declare function planAddTag(rows: readonly ContactBulkRow[], tag: string): ContactBulkSelection;
+/** The rows taking one tag off reaches: the ones that carry it. */
+export declare function planRemoveTag(rows: readonly ContactBulkRow[], tag: string): ContactBulkSelection;
+/**
+ * The rows filing under one company reaches — or unlinking, with `null`
+ * (AGL-2613).
+ *
+ * A row already where it was asked to be is left out silently, as a row
+ * already tagged is. A row the table could not project a link state for is
+ * left out AND named: whether its link would change cannot be told, and the
+ * 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

@@ -0,0 +1,196 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ /**
+ * What a bulk action on the contacts table does to each row (AGL-2603, and
+ * through the server since AGL-2804).
+ *
+ * The bar over the table offers one act over many rows — tag them, hand them
+ * 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,
+ * and what this module decides is WHICH rows the request names — the bar
+ * holds only the controls.
+ *
+ * ## A row with nothing to change is left out, and a row that cannot be
+ * ## reached is REPORTED
+ *
+ * A row already carrying the tag, or already at the company, is left out of
+ * the request silently: the route would write nothing, and a report saying
+ * so would be noise. A row already at the tag cap, or whose company link the
+ * table could not project, is left out and named by address — a count of
+ * "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 };
+/** 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);
+/**
+ * A typed tag as the record page stores one, or `null` when nothing survives.
+ *
+ * Lowercased and trimmed because the record page lowercases and trims, and
+ * `contactMatchesSegment` compares lowercased — a bulk "VIP" beside a typed
+ * "vip" would otherwise be two tags on one list and one filter finding half
+ * of them.
+ */ export function normalizeBulkTag(input) {
+    const tag = input.trim().toLowerCase().slice(0, 60);
+    return tag || null;
+}
+/**
+ * The rows adding one tag reaches.
+ *
+ * A row that already carries the tag is left out silently. A row already at
+ * the cap without it is left out AND reported: the cap is the record page's,
+ * and a bulk path that slipped past it would leave a tag the page's next
+ * save silently drops.
+ */ export function planAddTag(rows, tag) {
+    const reached = [];
+    const skipped = [];
+    for (const row of rows){
+        var _row_tags;
+        const held = ((_row_tags = row.tags) != null ? _row_tags : []).map((held)=>held.toLowerCase());
+        if (held.includes(tag)) continue;
+        if (held.length >= CONTACT_TAGS_CAP) {
+            skipped.push({
+                email: contactBulkAddressOf(row),
+                reason: `already has ${CONTACT_TAGS_CAP} tags`
+            });
+            continue;
+        }
+        reached.push(row);
+    }
+    return {
+        rows: reached,
+        skipped
+    };
+}
+/** The rows taking one tag off reaches: the ones that carry it. */ export function planRemoveTag(rows, tag) {
+    return {
+        rows: rows.filter((row)=>{
+            var _row_tags;
+            return ((_row_tags = row.tags) != null ? _row_tags : []).map((held)=>held.toLowerCase()).includes(tag);
+        }),
+        skipped: []
+    };
+}
+/**
+ * The rows filing under one company reaches — or unlinking, with `null`
+ * (AGL-2613).
+ *
+ * A row already where it was asked to be is left out silently, as a row
+ * already tagged is. A row the table could not project a link state for is
+ * left out AND named: whether its link would change cannot be told, and the
+ * request is not the place to guess.
+ */ export function planSetCompany(rows, companyId) {
+    const reached = [];
+    const skipped = [];
+    for (const row of rows){
+        if (!row.companyLink) {
+            skipped.push({
+                email: contactBulkAddressOf(row),
+                reason: 'its company link could not be read'
+            });
+            continue;
+        }
+        if (planContactCompanyLink(row.companyLink, companyId)) reached.push(row);
+    }
+    return {
+        rows: reached,
+        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

@@ -0,0 +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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"}

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

@@ -0,0 +1,54 @@
+/**
+ * @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 contacts CSV — every CRM column, the same file from the table's
+ * Export button and the bulk bar's (AGL-2603, widened by AGL-2621).
+ *
+ * The selection's export and the table's export are the same file over a
+ * different set of rows: the same columns in the same order, the same `|`
+ * between multi-valued cells, the same quoting. A second column list would
+ * be a second file format for one feature, and the person opening both in
+ * a spreadsheet would be the one to find the difference.
+ *
+ * ## The header row is the import's own vocabulary
+ *
+ * Each column is headed by a name `guessContactImportMapping` recognizes —
+ * "Job title", "Address line 1", "Lifecycle stage", a custom field's label
+ * — so an export re-imports without a hand mapping, and the template the
+ * Import drawer offers IS this header over no rows. The owner column
+ * carries the member's ADDRESS rather than a uid for the same reason: the
+ * import resolves an owner by email, and a uid is nothing a spreadsheet
+ * can read anyway. The three columns the import has no field for — sources,
+ * 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.
+ */
+export { CONTACT_CSV_COLUMNS, contactCsvHeader, contactsCsv, type ContactCsvOptions, type ContactCsvRow, } from '@aglyn/aglyn';
+import { type ContactCsvOptions } from '@aglyn/aglyn';
+/**
+ * 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.
+ */
+export declare function contactImportTemplateCsv(customFields?: ContactCsvOptions['customFields']): string;
+/**
+ * Hand the browser a file to save.
+ *
+ * The one writer that stayed: it touches `URL.createObjectURL` and
+ * `document`, so it belongs to the browser and not to the library a server
+ * route imports.
+ */
+export declare function downloadTextFile(name: string, mime: string, text: string): void;

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

@@ -0,0 +1,67 @@
+/**
+ * @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 contacts CSV — every CRM column, the same file from the table's
+ * Export button and the bulk bar's (AGL-2603, widened by AGL-2621).
+ *
+ * The selection's export and the table's export are the same file over a
+ * different set of rows: the same columns in the same order, the same `|`
+ * between multi-valued cells, the same quoting. A second column list would
+ * be a second file format for one feature, and the person opening both in
+ * a spreadsheet would be the one to find the difference.
+ *
+ * ## The header row is the import's own vocabulary
+ *
+ * Each column is headed by a name `guessContactImportMapping` recognizes —
+ * "Job title", "Address line 1", "Lifecycle stage", a custom field's label
+ * — so an export re-imports without a hand mapping, and the template the
+ * Import drawer offers IS this header over no rows. The owner column
+ * carries the member's ADDRESS rather than a uid for the same reason: the
+ * import resolves an owner by email, and a uid is nothing a spreadsheet
+ * can read anyway. The three columns the import has no field for — sources,
+ * 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 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.
+ */ export function contactImportTemplateCsv(customFields = []) {
+    return contactsCsv([], {
+        customFields
+    });
+}
+/**
+ * Hand the browser a file to save.
+ *
+ * The one writer that stayed: it touches `URL.createObjectURL` and
+ * `document`, so it belongs to the browser and not to the library a server
+ * route imports.
+ */ export function downloadTextFile(name, mime, text) {
+    const url = URL.createObjectURL(new Blob([
+        text
+    ], {
+        type: mime
+    }));
+    const anchor = document.createElement('a');
+    anchor.href = url;
+    anchor.download = name;
+    anchor.click();
+    URL.revokeObjectURL(url);
+}
+
+//# sourceMappingURL=contacts-csv.js.map

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

@@ -0,0 +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"}

package/src/lib/model/contacts-list-seed.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @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 ContactSource } from '@aglyn/aglyn';
+import type { ListFilterRequest } from '@aglyn/shared-ui-jsx/const/list-filter';
+/** What the Contacts list opens ON, read off its own address. */
+export interface ContactsListSeed {
+    /** The grid filter to start with — the query's predicate — or none. */
+    filter: ListFilterRequest | null;
+    /** The source select's starting value. */
+    source: ContactSource | '';
+    /** The form the list was opened for, when it was. */
+    formId: string | null;
+    /**
+     * The address the list was asked to OPEN, normalized, when it was — the
+     * list moves on to the record itself once exactly one row matches.
+     */
+    openEmail: string | null;
+}
+/**
+ * The Contacts list's starting state, from the query string another surface
+ * sent it with (AGL-2612).
+ *
+ * Two surfaces address the list rather than a record: a form's own page,
+ * asking for the people that form captured, and an Inbox submission row,
+ * asking for the person with this address. Each is a filter the list
+ * already speaks — `formIds contains` and `email equals` — so the seed is
+ * the SAME `ListFilterRequest` the grid's own panel would produce, and the
+ * query built from it is the query a typed filter builds. Nothing here is a
+ * second predicate.
+ *
+ * Pure, and strict about what it accepts: an unknown source or an address
+ * that is not one seeds nothing rather than a filter that matches nothing,
+ * because an empty list under a bad link reads as "no such people".
+ */
+export declare function contactsListSeed(params: {
+    get(name: string): string | null;
+} | null | undefined): ContactsListSeed;

package/src/lib/model/contacts-list-seed.js

@@ -0,0 +1,63 @@
+/**
+ * @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 { CONTACT_SOURCE_LABELS, normalizeContactEmail } from "@aglyn/aglyn";
+import { CONTACTS_LIST_EMAIL_PARAM, CONTACTS_LIST_FORM_PARAM, CONTACTS_LIST_SOURCE_PARAM } from "./crm-routes.js";
+const NO_SEED = {
+    filter: null,
+    source: '',
+    formId: null,
+    openEmail: null
+};
+/**
+ * The Contacts list's starting state, from the query string another surface
+ * sent it with (AGL-2612).
+ *
+ * Two surfaces address the list rather than a record: a form's own page,
+ * asking for the people that form captured, and an Inbox submission row,
+ * asking for the person with this address. Each is a filter the list
+ * already speaks — `formIds contains` and `email equals` — so the seed is
+ * the SAME `ListFilterRequest` the grid's own panel would produce, and the
+ * query built from it is the query a typed filter builds. Nothing here is a
+ * second predicate.
+ *
+ * Pure, and strict about what it accepts: an unknown source or an address
+ * that is not one seeds nothing rather than a filter that matches nothing,
+ * because an empty list under a bad link reads as "no such people".
+ */ export function contactsListSeed(params) {
+    var _params_get, _params_get1;
+    if (!params) return NO_SEED;
+    const rawSource = (_params_get = params.get(CONTACTS_LIST_SOURCE_PARAM)) != null ? _params_get : '';
+    const source = rawSource in CONTACT_SOURCE_LABELS ? rawSource : '';
+    const formId = ((_params_get1 = params.get(CONTACTS_LIST_FORM_PARAM)) != null ? _params_get1 : '').trim() || null;
+    const openEmail = normalizeContactEmail(params.get(CONTACTS_LIST_EMAIL_PARAM));
+    const filter = formId ? {
+        field: 'formIds',
+        op: 'contains',
+        value: formId
+    } : openEmail ? {
+        field: 'email',
+        op: 'equals',
+        value: openEmail
+    } : null;
+    return {
+        filter,
+        source,
+        formId,
+        openEmail
+    };
+}
+
+//# sourceMappingURL=contacts-list-seed.js.map

package/src/lib/model/contacts-list-seed.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/model/contacts-list-seed.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 {\n  CONTACT_SOURCE_LABELS,\n  type ContactSource,\n  normalizeContactEmail,\n} from '@aglyn/aglyn'\nimport type { ListFilterRequest } from '@aglyn/shared-ui-jsx/const/list-filter'\nimport {\n  CONTACTS_LIST_EMAIL_PARAM,\n  CONTACTS_LIST_FORM_PARAM,\n  CONTACTS_LIST_SOURCE_PARAM,\n} from './crm-routes'\n\n/** What the Contacts list opens ON, read off its own address. */\nexport interface ContactsListSeed {\n  /** The grid filter to start with — the query's predicate — or none. */\n  filter: ListFilterRequest | null\n  /** The source select's starting value. */\n  source: ContactSource | ''\n  /** The form the list was opened for, when it was. */\n  formId: string | null\n  /**\n   * The address the list was asked to OPEN, normalized, when it was — the\n   * list moves on to the record itself once exactly one row matches.\n   */\n  openEmail: string | null\n}\n\nconst NO_SEED: ContactsListSeed = {\n  filter: null,\n  source: '',\n  formId: null,\n  openEmail: null,\n}\n\n/**\n * The Contacts list's starting state, from the query string another surface\n * sent it with (AGL-2612).\n *\n * Two surfaces address the list rather than a record: a form's own page,\n * asking for the people that form captured, and an Inbox submission row,\n * asking for the person with this address. Each is a filter the list\n * already speaks — `formIds contains` and `email equals` — so the seed is\n * the SAME `ListFilterRequest` the grid's own panel would produce, and the\n * query built from it is the query a typed filter builds. Nothing here is a\n * second predicate.\n *\n * Pure, and strict about what it accepts: an unknown source or an address\n * that is not one seeds nothing rather than a filter that matches nothing,\n * because an empty list under a bad link reads as \"no such people\".\n */\nexport function contactsListSeed(\n  params: { get(name: string): string | null } | null | undefined,\n): ContactsListSeed {\n  if (!params) return NO_SEED\n  const rawSource = params.get(CONTACTS_LIST_SOURCE_PARAM) ?? ''\n  const source =\n    rawSource in CONTACT_SOURCE_LABELS ? (rawSource as ContactSource) : ''\n  const formId = (params.get(CONTACTS_LIST_FORM_PARAM) ?? '').trim() || null\n  const openEmail = normalizeContactEmail(\n    params.get(CONTACTS_LIST_EMAIL_PARAM),\n  )\n  const filter: ListFilterRequest | null = formId\n    ? { field: 'formIds', op: 'contains', value: formId }\n    : openEmail\n      ? { field: 'email', op: 'equals', value: openEmail }\n      : null\n  return { filter, source, formId, openEmail }\n}\n"],"names":["CONTACT_SOURCE_LABELS","normalizeContactEmail","CONTACTS_LIST_EMAIL_PARAM","CONTACTS_LIST_FORM_PARAM","CONTACTS_LIST_SOURCE_PARAM","NO_SEED","filter","source","formId","openEmail","contactsListSeed","params","rawSource","get","trim","field","op","value"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SACEA,qBAAqB,EAErBC,qBAAqB,QAChB,eAAc;AAErB,SACEC,yBAAyB,EACzBC,wBAAwB,EACxBC,0BAA0B,QACrB,kBAAc;AAiBrB,MAAMC,UAA4B;IAChCC,QAAQ;IACRC,QAAQ;IACRC,QAAQ;IACRC,WAAW;AACb;AAEA;;;;;;;;;;;;;;;CAeC,GACD,OAAO,SAASC,iBACdC,MAA+D;QAG7CA,aAGFA;IAJhB,IAAI,CAACA,QAAQ,OAAON;IACpB,MAAMO,aAAYD,cAAAA,OAAOE,GAAG,CAACT,uCAAXO,cAA0C;IAC5D,MAAMJ,SACJK,aAAaZ,wBAAyBY,YAA8B;IACtE,MAAMJ,SAAS,EAACG,eAAAA,OAAOE,GAAG,CAACV,qCAAXQ,eAAwC,IAAIG,IAAI,MAAM;IACtE,MAAML,YAAYR,sBAChBU,OAAOE,GAAG,CAACX;IAEb,MAAMI,SAAmCE,SACrC;QAAEO,OAAO;QAAWC,IAAI;QAAYC,OAAOT;IAAO,IAClDC,YACE;QAAEM,OAAO;QAASC,IAAI;QAAUC,OAAOR;IAAU,IACjD;IACN,OAAO;QAAEH;QAAQC;QAAQC;QAAQC;IAAU;AAC7C"}