@aglyn/tenant-data-admin 1.0.0-beta.218 → 1.0.0-beta.220

package/src/lib/server/contact-merge.d.ts

@@ -1,55 +0,0 @@
-/**
- * @license
- * Copyright 2026 Aglyn LLC
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *   http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-import type { HostActivityActor } from '@aglyn/aglyn/app-utils/activity-presenter';
-export interface MergeContactsOptions {
-    firestore: FirebaseFirestore.Firestore;
-    /** `orgs/{orgId}` — the org whose contacts both records are. */
-    orgRef: FirebaseFirestore.DocumentReference;
-    /** The record that stays, and keeps its address as the identity. */
-    survivorId: string;
-    /** The record folded in and deleted. */
-    mergedId: string;
-    actor: HostActivityActor;
-    /**
-     * The site whose console did the work: where the activity feed entry
-     * lands, and the site a timeline note is filed under. `null` for a door
-     * with no site — the REST API — which logs no host entry.
-     */
-    hostId: string | null;
-    /** The actor's display name for the timeline note, when the door knows it. */
-    actorName?: string | null;
-}
-export interface MergeContactsRepointed {
-    deals: number;
-    tasks: number;
-    activities: number;
-    leads: number;
-}
-export type MergeContactsResult = {
-    ok: true;
-    survivorId: string;
-    survivorEmail: string;
-    mergedId: string;
-    mergedEmail: string;
-    /** Every address the survivor answers to now, primary first. */
-    emails: string[];
-    repointed: MergeContactsRepointed;
-} | {
-    ok: false;
-    reason: 'same-record' | 'survivor-missing' | 'merged-missing';
-};
-export declare function mergeContacts(options: MergeContactsOptions): Promise<MergeContactsResult>;

package/src/lib/server/contact-merge.js

@@ -1,288 +0,0 @@
-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.
- */ /**
- * MERGING TWO CONTACTS — the write (AGL-2625).
- *
- * `planContactMerge` says what the survivor becomes; this performs it, and
- * moves everything that pointed at the merged record. One function behind
- * two doors — the console's `crm/contacts-merge` route and
- * `POST /v1/contacts/{id}/merge` — so the REST caller and the record page
- * cannot merge two different ways.
- *
- * ## The order is the crash-safety argument
- *
- *  1. Every deal, task and activity naming the merged contact is repointed
- *     at the survivor, and every lead converted into it. Batched, bounded,
- *     idempotent: a re-run finds nothing left to move.
- *  2. Then, in ONE transaction: the survivor takes the plan, every address
- *     it now answers to is indexed at it, and the merged document is
- *     deleted — with both records re-read inside the transaction, so two
- *     merges racing on one pair cannot both succeed and a plan is never
- *     computed on a document that changed under it.
- *
- * Children first because a process that dies between the two steps leaves
- * children pointing at a record that EXISTS — the survivor — while the merged
- * document is still there for a retry to fold in. The other order would
- * leave deals pointing at a deleted contact, which is a record nobody can
- * open from anywhere.
- *
- * ## What it does not move
- *
- * List memberships, suppression entries and the delivery log are keyed by
- * ADDRESS, not by contact id, and stay under the merged address; a capture
- * on that address resolves to the survivor through the index, which is the
- * fact those keys need. A company's contacts count drops only for a company
- * both records named — the survivor still names the rest.
- */ import { CONTACT_EMAIL_INDEX_COLLECTION, contactEmails } from "@aglyn/aglyn/app-utils/contacts";
-import { planContactMerge } from "@aglyn/aglyn/app-utils/contact-merge";
-import { CRM_COLLECTIONS } from "@aglyn/aglyn/app-utils/crm";
-import { personKey } from "@aglyn/aglyn/app-utils/person-key";
-import { FieldValue } from "firebase-admin/firestore";
-import { settleCompanyContactsCounts } from "./contact-company-link.js";
-import { recomputeCrmNextTaskAt } from "./crm-next-activity.js";
-import { restampCrmListFieldsAt } from "./crm-records.js";
-import { logHostActivity } from "./organizations.js";
-/** How many pointing rows one repoint pass reads — and one batch writes. */ const REPOINT_PAGE = 400;
-/** A ceiling on passes, so a query that keeps answering cannot loop forever. */ const REPOINT_PASSES = 25;
-/**
- * Point every row of `collection` whose `contactId` is `from` at `to`.
- *
- * Page, batch, repeat: each pass reads the rows still pointing at the
- * merged record — the ones a previous pass moved no longer match — so the
- * loop ends when a pass finds nothing. `updatedAt` moves with the pointer
- * because an integration syncing by `updatedAfter` has to see the change.
- */ async function repointContactId(firestore, collection, from, to) {
-    let moved = 0;
-    for(let pass = 0; pass < REPOINT_PASSES; pass += 1){
-        const page = await collection.where('contactId', '==', from).limit(REPOINT_PAGE).get();
-        if (page.empty) break;
-        const batch = firestore.batch();
-        for (const row of page.docs){
-            batch.update(row.ref, {
-                contactId: to,
-                updatedAt: FieldValue.serverTimestamp()
-            });
-        }
-        await batch.commit();
-        moved += page.size;
-        if (page.size < REPOINT_PAGE) break;
-    }
-    return moved;
-}
-/**
- * The leads converted into the merged contact, restamped at the survivor.
- *
- * A lead lives at `orgs/{orgId}/leads/{personKey(email)}` (AGL-3275), so there
- * is still no query — one document per address, asked for directly. This used
- * to be bounded by sites TIMES addresses because a lead lived under each site;
- * it is bounded by addresses now, and the sites drop out of the signature
- * because the collection no longer has one per site to walk.
- */ async function repointLeads(orgRef, emails, from, to) {
-    let moved = 0;
-    /*
-   * ONE ROW PER ADDRESS, on the org (AGL-3275). This walked the sites because
-   * there was a lead under each of them; re-pointing the same document once
-   * per site would now be the same write repeated, and the second would find
-   * `convertedContactId` already moved and skip — a silent undercount rather
-   * than a wrong answer, but an undercount the caller reports to the operator.
-   */ for (const email of emails){
-        const key = personKey(email);
-        if (!key) continue;
-        const leadRef = orgRef.collection('leads').doc(key);
-        const lead = await leadRef.get();
-        if (!lead.exists || lead.get('convertedContactId') !== from) continue;
-        await leadRef.update({
-            convertedContactId: to,
-            updatedAt: FieldValue.serverTimestamp()
-        });
-        moved += 1;
-    }
-    return moved;
-}
-function strings(value) {
-    return Array.isArray(value) ? value.filter((item)=>typeof item === 'string' && item !== '') : [];
-}
-export async function mergeContacts(options) {
-    var _mergedBefore_data, _survivorBefore_data, _contactEmails_, _plan_emails_;
-    const { firestore, orgRef, survivorId, mergedId, actor, hostId } = options;
-    if (!survivorId || !mergedId || survivorId === mergedId) {
-        return {
-            ok: false,
-            reason: 'same-record'
-        };
-    }
-    const contactsRef = orgRef.collection('contacts');
-    const survivorRef = contactsRef.doc(survivorId);
-    const mergedRef = contactsRef.doc(mergedId);
-    const [survivorBefore, mergedBefore] = await Promise.all([
-        survivorRef.get(),
-        mergedRef.get()
-    ]);
-    if (!survivorBefore.exists) return {
-        ok: false,
-        reason: 'survivor-missing'
-    };
-    if (!mergedBefore.exists) return {
-        ok: false,
-        reason: 'merged-missing'
-    };
-    const mergedData = (_mergedBefore_data = mergedBefore.data()) != null ? _mergedBefore_data : {};
-    const survivorData = (_survivorBefore_data = survivorBefore.data()) != null ? _survivorBefore_data : {};
-    /*==========================================
-   * 1. THE CHILDREN — before the parent, for the reason the header gives.
-   *=========================================*/ const [deals, tasks, activities] = await Promise.all([
-        repointContactId(firestore, orgRef.collection(CRM_COLLECTIONS.deals), mergedId, survivorId),
-        repointContactId(firestore, orgRef.collection(CRM_COLLECTIONS.tasks), mergedId, survivorId),
-        repointContactId(firestore, orgRef.collection(CRM_COLLECTIONS.activities), mergedId, survivorId)
-    ]);
-    const leadHosts = [
-        ...new Set([
-            ...strings(mergedData['capturedByHostIds']),
-            ...strings(survivorData['capturedByHostIds']),
-            ...strings([
-                mergedData['hostId'],
-                survivorData['hostId'],
-                hostId
-            ])
-        ])
-    ];
-    const leads = await repointLeads(orgRef, contactEmails(mergedData), mergedId, survivorId);
-    /*==========================================
-   * 2. THE SWAP — one transaction over both documents and the index.
-   *=========================================*/ const index = orgRef.collection(CONTACT_EMAIL_INDEX_COLLECTION);
-    const swapped = await firestore.runTransaction(async (transaction)=>{
-        var _survivor_data, _merged_data, _survivor_data1;
-        const [survivor, merged] = await Promise.all([
-            transaction.get(survivorRef),
-            transaction.get(mergedRef)
-        ]);
-        if (!survivor.exists) return {
-            reason: 'survivor-missing'
-        };
-        if (!merged.exists) return {
-            reason: 'merged-missing'
-        };
-        const plan = planContactMerge((_survivor_data = survivor.data()) != null ? _survivor_data : {}, (_merged_data = merged.data()) != null ? _merged_data : {});
-        transaction.set(survivorRef, _extends({}, plan.survivor, {
-            updatedAt: FieldValue.serverTimestamp()
-        }), {
-            merge: true
-        });
-        for (const email of plan.emails){
-            const key = personKey(email);
-            if (!key) continue;
-            transaction.set(index.doc(key), {
-                email,
-                contactId: survivorId,
-                updatedAt: FieldValue.serverTimestamp()
-            }, {
-                merge: true
-            });
-        }
-        transaction.delete(mergedRef);
-        return {
-            plan,
-            survivor: (_survivor_data1 = survivor.data()) != null ? _survivor_data1 : {}
-        };
-    });
-    if ('reason' in swapped) return {
-        ok: false,
-        reason: swapped.reason
-    };
-    const { plan } = swapped;
-    // The survivor now carries both records' addresses, holders and facets —
-    // what the Contacts list searches and filters by (AGL-3321).
-    await restampCrmListFieldsAt(survivorRef, 'contacts');
-    /*
-   * The companies both records named counted two people and now count one
-   * (AGL-2613). Settled after the swap the way the capture settles its
-   * counts: a figure that could not move is logged, and the company page's
-   * live aggregate corrects it.
-   */ await settleCompanyContactsCounts(orgRef.collection(CRM_COLLECTIONS.companies), {
-        companyId: null,
-        mirror: null,
-        counts: plan.companyCounts
-    });
-    /*
-   * The survivor now owns the merged record's open tasks too, so its next
-   * activity is the earliest of both (AGL-2661). Settled the same way: a
-   * figure that could not move is logged, and the Fields section's
-   * recompute corrects it.
-   */ await recomputeCrmNextTaskAt(firestore, orgRef.id, [
-        {
-            contactId: survivorId
-        }
-    ]).catch((error)=>{
-        console.error('contact merge next activity could not be recomputed', survivorId, error);
-    });
-    const mergedEmail = (_contactEmails_ = contactEmails(mergedData)[0]) != null ? _contactEmails_ : '';
-    const survivorEmail = (_plan_emails_ = plan.emails[0]) != null ? _plan_emails_ : '';
-    // The canonical name — the one identity every holder shares — for the
-    // feed; the address stands in for a person nobody has named.
-    const survivorName = typeof swapped.survivor['name'] === 'string' ? swapped.survivor['name'] : '';
-    /*
-   * THE TIMELINE NOTE, on the survivor: the merge is an event in this
-   * person's history, and the record page is where a reader looks for one.
-   * Filed under the calling site, or the survivor's first site for a door
-   * with none; its own catch, because a note that could not be written must
-   * not read as a merge that did not happen.
-   */ try {
-        var _survivorData_hostId;
-        await orgRef.collection(CRM_COLLECTIONS.activities).add(_extends({
-            kind: 'note',
-            body: `Merged with ${mergedEmail}`,
-            atMs: Date.now(),
-            byUid: actor.uid
-        }, options.actorName || actor.email ? {
-            byName: options.actorName || actor.email
-        } : {}, {
-            contactId: survivorId,
-            visibleTo: plan.visibleTo,
-            hostId: hostId != null ? hostId : String((_survivorData_hostId = survivorData['hostId']) != null ? _survivorData_hostId : ''),
-            createdByUid: actor.uid,
-            createdAt: FieldValue.serverTimestamp(),
-            updatedAt: FieldValue.serverTimestamp()
-        }));
-    } catch (error) {
-        console.error('[contact-merge] timeline note failed', survivorId, error);
-    }
-    // The audit line (AGL-2622), in the feed of the site whose console did
-    // the work. A door with no site — the API — has no host feed to write.
-    if (hostId) {
-        await logHostActivity(hostId, actor, `Merged with ${mergedEmail}`, {
-            type: 'contact',
-            id: survivorId,
-            name: survivorName || survivorEmail
-        });
-    }
-    return {
-        ok: true,
-        survivorId,
-        survivorEmail,
-        mergedId,
-        mergedEmail,
-        emails: plan.emails,
-        repointed: {
-            deals,
-            tasks,
-            activities,
-            leads
-        }
-    };
-}
-
-//# sourceMappingURL=contact-merge.js.map

package/src/lib/server/contact-merge.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../../../../../libs/tenant/data/admin/src/lib/server/contact-merge.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 * MERGING TWO CONTACTS — the write (AGL-2625).\n *\n * `planContactMerge` says what the survivor becomes; this performs it, and\n * moves everything that pointed at the merged record. One function behind\n * two doors — the console's `crm/contacts-merge` route and\n * `POST /v1/contacts/{id}/merge` — so the REST caller and the record page\n * cannot merge two different ways.\n *\n * ## The order is the crash-safety argument\n *\n *  1. Every deal, task and activity naming the merged contact is repointed\n *     at the survivor, and every lead converted into it. Batched, bounded,\n *     idempotent: a re-run finds nothing left to move.\n *  2. Then, in ONE transaction: the survivor takes the plan, every address\n *     it now answers to is indexed at it, and the merged document is\n *     deleted — with both records re-read inside the transaction, so two\n *     merges racing on one pair cannot both succeed and a plan is never\n *     computed on a document that changed under it.\n *\n * Children first because a process that dies between the two steps leaves\n * children pointing at a record that EXISTS — the survivor — while the merged\n * document is still there for a retry to fold in. The other order would\n * leave deals pointing at a deleted contact, which is a record nobody can\n * open from anywhere.\n *\n * ## What it does not move\n *\n * List memberships, suppression entries and the delivery log are keyed by\n * ADDRESS, not by contact id, and stay under the merged address; a capture\n * on that address resolves to the survivor through the index, which is the\n * fact those keys need. A company's contacts count drops only for a company\n * both records named — the survivor still names the rest.\n */\n\nimport {\n  CONTACT_EMAIL_INDEX_COLLECTION,\n  contactEmails,\n} from '@aglyn/aglyn/app-utils/contacts'\nimport type { HostActivityActor } from '@aglyn/aglyn/app-utils/activity-presenter'\nimport { planContactMerge } from '@aglyn/aglyn/app-utils/contact-merge'\nimport { CRM_COLLECTIONS } from '@aglyn/aglyn/app-utils/crm'\nimport { personKey } from '@aglyn/aglyn/app-utils/person-key'\nimport { FieldValue } from 'firebase-admin/firestore'\nimport { settleCompanyContactsCounts } from './contact-company-link'\nimport { recomputeCrmNextTaskAt } from './crm-next-activity'\nimport { restampCrmListFieldsAt } from './crm-records'\nimport { logHostActivity } from './organizations'\n\n/** How many pointing rows one repoint pass reads — and one batch writes. */\nconst REPOINT_PAGE = 400\n/** A ceiling on passes, so a query that keeps answering cannot loop forever. */\nconst REPOINT_PASSES = 25\n\nexport interface MergeContactsOptions {\n  firestore: FirebaseFirestore.Firestore\n  /** `orgs/{orgId}` — the org whose contacts both records are. */\n  orgRef: FirebaseFirestore.DocumentReference\n  /** The record that stays, and keeps its address as the identity. */\n  survivorId: string\n  /** The record folded in and deleted. */\n  mergedId: string\n  actor: HostActivityActor\n  /**\n   * The site whose console did the work: where the activity feed entry\n   * lands, and the site a timeline note is filed under. `null` for a door\n   * with no site — the REST API — which logs no host entry.\n   */\n  hostId: string | null\n  /** The actor's display name for the timeline note, when the door knows it. */\n  actorName?: string | null\n}\n\nexport interface MergeContactsRepointed {\n  deals: number\n  tasks: number\n  activities: number\n  leads: number\n}\n\nexport type MergeContactsResult =\n  | {\n      ok: true\n      survivorId: string\n      survivorEmail: string\n      mergedId: string\n      mergedEmail: string\n      /** Every address the survivor answers to now, primary first. */\n      emails: string[]\n      repointed: MergeContactsRepointed\n    }\n  | { ok: false; reason: 'same-record' | 'survivor-missing' | 'merged-missing' }\n\n/**\n * Point every row of `collection` whose `contactId` is `from` at `to`.\n *\n * Page, batch, repeat: each pass reads the rows still pointing at the\n * merged record — the ones a previous pass moved no longer match — so the\n * loop ends when a pass finds nothing. `updatedAt` moves with the pointer\n * because an integration syncing by `updatedAfter` has to see the change.\n */\nasync function repointContactId(\n  firestore: FirebaseFirestore.Firestore,\n  collection: FirebaseFirestore.CollectionReference,\n  from: string,\n  to: string,\n): Promise<number> {\n  let moved = 0\n  for (let pass = 0; pass < REPOINT_PASSES; pass += 1) {\n    const page = await collection\n      .where('contactId', '==', from)\n      .limit(REPOINT_PAGE)\n      .get()\n    if (page.empty) break\n    const batch = firestore.batch()\n    for (const row of page.docs) {\n      batch.update(row.ref, {\n        contactId: to,\n        updatedAt: FieldValue.serverTimestamp(),\n      })\n    }\n    await batch.commit()\n    moved += page.size\n    if (page.size < REPOINT_PAGE) break\n  }\n  return moved\n}\n\n/**\n * The leads converted into the merged contact, restamped at the survivor.\n *\n * A lead lives at `orgs/{orgId}/leads/{personKey(email)}` (AGL-3275), so there\n * is still no query — one document per address, asked for directly. This used\n * to be bounded by sites TIMES addresses because a lead lived under each site;\n * it is bounded by addresses now, and the sites drop out of the signature\n * because the collection no longer has one per site to walk.\n */\nasync function repointLeads(\n  orgRef: FirebaseFirestore.DocumentReference,\n  emails: readonly string[],\n  from: string,\n  to: string,\n): Promise<number> {\n  let moved = 0\n  /*\n   * ONE ROW PER ADDRESS, on the org (AGL-3275). This walked the sites because\n   * there was a lead under each of them; re-pointing the same document once\n   * per site would now be the same write repeated, and the second would find\n   * `convertedContactId` already moved and skip — a silent undercount rather\n   * than a wrong answer, but an undercount the caller reports to the operator.\n   */\n  for (const email of emails) {\n    const key = personKey(email)\n    if (!key) continue\n    const leadRef = orgRef.collection('leads').doc(key)\n    const lead = await leadRef.get()\n    if (!lead.exists || lead.get('convertedContactId') !== from) continue\n    await leadRef.update({\n      convertedContactId: to,\n      updatedAt: FieldValue.serverTimestamp(),\n    })\n    moved += 1\n  }\n  return moved\n}\n\nfunction strings(value: unknown): string[] {\n  return Array.isArray(value)\n    ? value.filter((item): item is string => typeof item === 'string' && item !== '')\n    : []\n}\n\nexport async function mergeContacts(\n  options: MergeContactsOptions,\n): Promise<MergeContactsResult> {\n  const { firestore, orgRef, survivorId, mergedId, actor, hostId } = options\n  if (!survivorId || !mergedId || survivorId === mergedId) {\n    return { ok: false, reason: 'same-record' }\n  }\n  const contactsRef = orgRef.collection('contacts')\n  const survivorRef = contactsRef.doc(survivorId)\n  const mergedRef = contactsRef.doc(mergedId)\n  const [survivorBefore, mergedBefore] = await Promise.all([\n    survivorRef.get(),\n    mergedRef.get(),\n  ])\n  if (!survivorBefore.exists) return { ok: false, reason: 'survivor-missing' }\n  if (!mergedBefore.exists) return { ok: false, reason: 'merged-missing' }\n  const mergedData = (mergedBefore.data() ?? {}) as Record<string, unknown>\n  const survivorData = (survivorBefore.data() ?? {}) as Record<string, unknown>\n\n  /*==========================================\n   * 1. THE CHILDREN — before the parent, for the reason the header gives.\n   *=========================================*/\n  const [deals, tasks, activities] = await Promise.all([\n    repointContactId(firestore, orgRef.collection(CRM_COLLECTIONS.deals), mergedId, survivorId),\n    repointContactId(firestore, orgRef.collection(CRM_COLLECTIONS.tasks), mergedId, survivorId),\n    repointContactId(\n      firestore,\n      orgRef.collection(CRM_COLLECTIONS.activities),\n      mergedId,\n      survivorId,\n    ),\n  ])\n  const leadHosts = [\n    ...new Set([\n      ...strings(mergedData['capturedByHostIds']),\n      ...strings(survivorData['capturedByHostIds']),\n      ...strings([mergedData['hostId'], survivorData['hostId'], hostId]),\n    ]),\n  ]\n  const leads = await repointLeads(\n    orgRef,\n    contactEmails(mergedData),\n    mergedId,\n    survivorId,\n  )\n\n  /*==========================================\n   * 2. THE SWAP — one transaction over both documents and the index.\n   *=========================================*/\n  const index = orgRef.collection(CONTACT_EMAIL_INDEX_COLLECTION)\n  const swapped = await firestore.runTransaction(async (transaction) => {\n    const [survivor, merged] = await Promise.all([\n      transaction.get(survivorRef),\n      transaction.get(mergedRef),\n    ])\n    if (!survivor.exists) return { reason: 'survivor-missing' as const }\n    if (!merged.exists) return { reason: 'merged-missing' as const }\n    const plan = planContactMerge(\n      (survivor.data() ?? {}) as Record<string, unknown>,\n      (merged.data() ?? {}) as Record<string, unknown>,\n    )\n    transaction.set(\n      survivorRef,\n      { ...plan.survivor, updatedAt: FieldValue.serverTimestamp() },\n      { merge: true },\n    )\n    for (const email of plan.emails) {\n      const key = personKey(email)\n      if (!key) continue\n      transaction.set(\n        index.doc(key),\n        { email, contactId: survivorId, updatedAt: FieldValue.serverTimestamp() },\n        { merge: true },\n      )\n    }\n    transaction.delete(mergedRef)\n    return { plan, survivor: (survivor.data() ?? {}) as Record<string, unknown> }\n  })\n  if ('reason' in swapped) return { ok: false, reason: swapped.reason }\n  const { plan } = swapped\n  // The survivor now carries both records' addresses, holders and facets —\n  // what the Contacts list searches and filters by (AGL-3321).\n  await restampCrmListFieldsAt(survivorRef, 'contacts')\n\n  /*\n   * The companies both records named counted two people and now count one\n   * (AGL-2613). Settled after the swap the way the capture settles its\n   * counts: a figure that could not move is logged, and the company page's\n   * live aggregate corrects it.\n   */\n  await settleCompanyContactsCounts(orgRef.collection(CRM_COLLECTIONS.companies), {\n    companyId: null,\n    mirror: null,\n    counts: plan.companyCounts,\n  })\n  /*\n   * The survivor now owns the merged record's open tasks too, so its next\n   * activity is the earliest of both (AGL-2661). Settled the same way: a\n   * figure that could not move is logged, and the Fields section's\n   * recompute corrects it.\n   */\n  await recomputeCrmNextTaskAt(firestore, orgRef.id, [{ contactId: survivorId }]).catch(\n    (error: unknown) => {\n      console.error('contact merge next activity could not be recomputed', survivorId, error)\n    },\n  )\n\n  const mergedEmail = contactEmails(mergedData)[0] ?? ''\n  const survivorEmail = plan.emails[0] ?? ''\n  // The canonical name — the one identity every holder shares — for the\n  // feed; the address stands in for a person nobody has named.\n  const survivorName =\n    typeof swapped.survivor['name'] === 'string' ? swapped.survivor['name'] : ''\n\n  /*\n   * THE TIMELINE NOTE, on the survivor: the merge is an event in this\n   * person's history, and the record page is where a reader looks for one.\n   * Filed under the calling site, or the survivor's first site for a door\n   * with none; its own catch, because a note that could not be written must\n   * not read as a merge that did not happen.\n   */\n  try {\n    await orgRef.collection(CRM_COLLECTIONS.activities).add({\n      kind: 'note',\n      body: `Merged with ${mergedEmail}`,\n      atMs: Date.now(),\n      byUid: actor.uid,\n      ...(options.actorName || actor.email\n        ? { byName: options.actorName || actor.email }\n        : {}),\n      contactId: survivorId,\n      visibleTo: plan.visibleTo,\n      hostId: hostId ?? String(survivorData['hostId'] ?? ''),\n      createdByUid: actor.uid,\n      createdAt: FieldValue.serverTimestamp(),\n      updatedAt: FieldValue.serverTimestamp(),\n    })\n  } catch (error) {\n    console.error('[contact-merge] timeline note failed', survivorId, error)\n  }\n\n  // The audit line (AGL-2622), in the feed of the site whose console did\n  // the work. A door with no site — the API — has no host feed to write.\n  if (hostId) {\n    await logHostActivity(hostId, actor, `Merged with ${mergedEmail}`, {\n      type: 'contact',\n      id: survivorId,\n      name: survivorName || survivorEmail,\n    })\n  }\n\n  return {\n    ok: true,\n    survivorId,\n    survivorEmail,\n    mergedId,\n    mergedEmail,\n    emails: plan.emails,\n    repointed: { deals, tasks, activities, leads },\n  }\n}\n"],"names":["CONTACT_EMAIL_INDEX_COLLECTION","contactEmails","planContactMerge","CRM_COLLECTIONS","personKey","FieldValue","settleCompanyContactsCounts","recomputeCrmNextTaskAt","restampCrmListFieldsAt","logHostActivity","REPOINT_PAGE","REPOINT_PASSES","repointContactId","firestore","collection","from","to","moved","pass","page","where","limit","get","empty","batch","row","docs","update","ref","contactId","updatedAt","serverTimestamp","commit","size","repointLeads","orgRef","emails","email","key","leadRef","doc","lead","exists","convertedContactId","strings","value","Array","isArray","filter","item","mergeContacts","options","mergedBefore","survivorBefore","plan","survivorId","mergedId","actor","hostId","ok","reason","contactsRef","survivorRef","mergedRef","Promise","all","mergedData","data","survivorData","deals","tasks","activities","leadHosts","Set","leads","index","swapped","runTransaction","transaction","survivor","merged","set","merge","delete","companies","companyId","mirror","counts","companyCounts","id","catch","error","console","mergedEmail","survivorEmail","survivorName","add","kind","body","atMs","Date","now","byUid","uid","actorName","byName","visibleTo","String","createdByUid","createdAt","type","name","repointed"],"mappings":"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"}

package/src/lib/server/crm-booking-activity.d.ts

@@ -1,86 +0,0 @@
-/**
- * @license
- * Copyright 2026 Aglyn LLC
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *   http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-import { type CrmActivityLink } from '@aglyn/aglyn/server';
-export interface CrmBookingRecordInput {
-    hostId: string;
-    /**
-     * The owning org, as `getOrgForHost` returns it — the plugin set, the
-     * consent groups and the scope default are all read off it.
-     */
-    org: Record<string, unknown> | null | undefined;
-    orgId: string;
-    /** The booking as its row was written. */
-    booking: {
-        id: string;
-        serviceId?: string;
-        serviceName?: string;
-        email?: string;
-        startsAtMs: number;
-        endsAtMs: number;
-        /** The `crm` query value the link carried, kept on the row. */
-        crmRef?: string | null;
-    };
-    /** The service as stored: its two CRM switches and its timezone. */
-    service: {
-        name?: string;
-        timezone?: string;
-        crmFollowUpTask?: boolean;
-        crmMeetingActivity?: boolean;
-    } | null | undefined;
-    /**
-     * The host document's plugin fields, when the caller already holds them;
-     * read here otherwise. The deny-list is per site, and a site that has
-     * switched the CRM off must file nothing.
-     */
-    host?: {
-        disabledPlugins?: string[];
-        enabledPlugins?: string[];
-    } | null;
-}
-export type CrmBookingRecordOutcome = {
-    filed: false;
-    reason: 
-    /** The CRM plugin does not run on this site. */
-    'crm-off'
-    /**
-     * The org's plan does not carry the CRM suite, whose activities and
-     * tasks these are (AGL-2787).
-     */
-     | 'not-entitled'
-    /** Neither the reference nor the address named a record. */
-     | 'no-record'
-    /** A meeting for this booking is already on the timeline. */
-     | 'already-filed'
-    /** The service asks for neither a meeting nor a follow-up. */
-     | 'nothing-to-file'
-    /** A read or a write threw; logged, and nothing is promised. */
-     | 'failed';
-} | {
-    filed: true;
-    /** How the record was found. */
-    matchedBy: 'crmRef' | 'email';
-    link: CrmActivityLink;
-    /** The meeting's id, or `null` when the service files no meeting. */
-    activityId: string | null;
-    /** The follow-up's id, or `null` when the service asks for none. */
-    taskId: string | null;
-};
-/**
- * Files what a confirmed booking owes the CRM: the meeting, and the
- * follow-up when the service asks for one. See the module comment.
- */
-export declare function recordCrmBooking(firestore: FirebaseFirestore.Firestore, input: CrmBookingRecordInput): Promise<CrmBookingRecordOutcome>;