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

package/src/lib/server/crm-booking-activity.js

@@ -1,257 +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.
- */ import { checkEntitlement, consentGroupForHost, CRM_COLLECTIONS, crmTaskListFields, crmActivityLogHasRoom, crmBookingFollowUpDueMs, crmBookingFollowUpTitle, crmBookingMeetingBody, crmScopeTokens, isHostPluginEnabled, parseCrmBookingRef, readContactFacet, visibleToHost } from "@aglyn/aglyn/server";
-import { FieldValue } from "firebase-admin/firestore";
-import { findContactByEmail } from "./contact-email-index.js";
-import { readLeadForHost } from "./host-visitor-records.js";
-import { countCrmActivitiesForRecord } from "./crm-records.js";
-/**
- * WHAT A BOOKING FILES ON THE CRM RECORD (AGL-2660).
- *
- * A confirmed booking is a meeting the record has on its calendar, and the
- * timeline should say so without a rep logging it by hand. So once a
- * booking's row is written — at creation for a free service, on payment
- * for a paid one — the record is found and a `meeting` activity filed under
- * it, with a follow-up task beside it when the service asks for one.
- *
- * ## Which record
- *
- * The reference the booking link carried wins: `crmRef` names the contact,
- * lead or deal the rep dropped the link from, and a booking made through
- * that link belongs to that record even when the booker typed a different
- * address. Without one — a booking taken off the widget cold — the booker's
- * address is looked up through the org's address index, narrowed to this
- * site, exactly as the automation steps resolve an event's contact. A
- * reference to a record the site cannot see, or that no longer exists,
- * falls through to the address rather than filing under nobody.
- *
- * ## Where it lives
- *
- * In the admin library rather than the Bookings plugin, because the row is
- * a CRM record: its scope, its ceiling and its collections are the CRM's,
- * and a plugin that stamped its own would be a second creator to keep in
- * step with `crmScopeTokens`. The Bookings plugin passes what it already
- * holds and reads the outcome; the CRM plugin is never imported.
- *
- * Firestore is a parameter, as in `crm-records.ts`: the callers hold one,
- * and a module that reached for the Admin app itself would drag it into
- * every spec that only wants the arithmetic.
- *
- * ## Failure posture
- *
- * **Never throws.** A booking that could not be filed on the CRM is still
- * a booking — the guest has the slot and the confirmation — so a failure
- * here is logged and reported in the outcome, never raised into the
- * request that took the booking or the webhook that confirmed it.
- */ /** The CRM plugin's id, as `enabledPlugins` and `disabledPlugins` name it. */ const CRM_PLUGIN_ID = 'crm';
-/**
- * The record a booking belongs to — the reference first, the address second.
- */ async function resolveBookingRecord(firestore, input, groupId) {
-    var _hit_data;
-    const { hostId, orgId } = input;
-    const orgRef = firestore.collection('orgs').doc(orgId);
-    const contactsRef = orgRef.collection('contacts');
-    const ref = parseCrmBookingRef(input.booking.crmRef);
-    if ((ref == null ? void 0 : ref.kind) === 'contact') {
-        const contact = await contactsRef.doc(ref.id).get();
-        if (contact.exists && visibleToHost(contact.get('visibleTo'), hostId)) {
-            var _contact_data;
-            const facet = readContactFacet((_contact_data = contact.data()) != null ? _contact_data : {}, groupId);
-            return _extends({
-                link: _extends({
-                    contactId: contact.id
-                }, facet.companyId ? {
-                    companyId: facet.companyId
-                } : {}),
-                matchedBy: 'crmRef'
-            }, facet.ownerUid ? {
-                ownerUid: facet.ownerUid
-            } : {});
-        }
-    }
-    if ((ref == null ? void 0 : ref.kind) === 'deal') {
-        const deal = await orgRef.collection(CRM_COLLECTIONS.deals).doc(ref.id).get();
-        if (deal.exists && visibleToHost(deal.get('visibleTo'), hostId)) {
-            var _deal_get, _deal_get1, _deal_get2;
-            const contactId = String((_deal_get = deal.get('contactId')) != null ? _deal_get : '');
-            const companyId = String((_deal_get1 = deal.get('companyId')) != null ? _deal_get1 : '');
-            const ownerUid = String((_deal_get2 = deal.get('ownerUid')) != null ? _deal_get2 : '');
-            return _extends({
-                link: _extends({
-                    dealId: deal.id
-                }, contactId ? {
-                    contactId
-                } : {}, companyId ? {
-                    companyId
-                } : {}),
-                matchedBy: 'crmRef'
-            }, ownerUid ? {
-                ownerUid
-            } : {});
-        }
-    }
-    if ((ref == null ? void 0 : ref.kind) === 'lead') {
-        /*
-     * A lead carries its own `visibleTo` now (AGL-3275) — it used to be
-     * host-scoped by path, and the comment here said so. The seam reads the
-     * org row, and the site has to be allowed to see it before a booking is
-     * filed against it, or one brand's booking would name another's lead.
-     */ const lead = await readLeadForHost(hostId, ref.id);
-        if (lead && visibleToHost(lead.get('visibleTo'), hostId)) {
-            var _lead_get;
-            const ownerUid = String((_lead_get = lead.get('ownerUid')) != null ? _lead_get : '');
-            return _extends({
-                link: {
-                    leadId: lead.id
-                },
-                matchedBy: 'crmRef'
-            }, ownerUid ? {
-                ownerUid
-            } : {});
-        }
-    }
-    const hit = await findContactByEmail(contactsRef, input.booking.email, {
-        hostId
-    });
-    if (!hit) return null;
-    const facet = readContactFacet((_hit_data = hit.data()) != null ? _hit_data : {}, groupId);
-    return _extends({
-        link: _extends({
-            contactId: hit.id
-        }, facet.companyId ? {
-            companyId: facet.companyId
-        } : {}),
-        matchedBy: 'email'
-    }, facet.ownerUid ? {
-        ownerUid: facet.ownerUid
-    } : {});
-}
-/**
- * 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 async function recordCrmBooking(firestore, input) {
-    const { hostId, orgId, booking, service } = input;
-    try {
-        var _data, _input_org, _input_org1, _input_org2, _ref, _ref1;
-        if (!hostId || !orgId || !(booking == null ? void 0 : booking.id)) return {
-            filed: false,
-            reason: 'failed'
-        };
-        const wantsMeeting = (service == null ? void 0 : service.crmMeetingActivity) !== false;
-        const wantsTask = (service == null ? void 0 : service.crmFollowUpTask) === true;
-        if (!wantsMeeting && !wantsTask) return {
-            filed: false,
-            reason: 'nothing-to-file'
-        };
-        const host = input.host === undefined ? (_data = (await firestore.collection('hosts').doc(hostId).get()).data()) != null ? _data : null : input.host;
-        if (!isHostPluginEnabled((_input_org = input.org) != null ? _input_org : null, host, CRM_PLUGIN_ID)) {
-            return {
-                filed: false,
-                reason: 'crm-off'
-            };
-        }
-        if (!checkEntitlement(input.org, 'crm')) {
-            return {
-                filed: false,
-                reason: 'not-entitled'
-            };
-        }
-        const orgRef = firestore.collection('orgs').doc(orgId);
-        const activities = orgRef.collection(CRM_COLLECTIONS.activities);
-        // One meeting per booking, whatever path re-enters: the paid webhook is
-        // redelivered for days after any 500, and its own guard is the status,
-        // which this row is not part of.
-        const already = await activities.where('bookingId', '==', booking.id).limit(1).get();
-        if (!already.empty) return {
-            filed: false,
-            reason: 'already-filed'
-        };
-        const group = consentGroupForHost((_input_org1 = input.org) != null ? _input_org1 : null, hostId);
-        const record = await resolveBookingRecord(firestore, input, group.groupId);
-        if (!record) return {
-            filed: false,
-            reason: 'no-record'
-        };
-        const visibleTo = crmScopeTokens((_input_org2 = input.org) != null ? _input_org2 : null, group);
-        const serviceName = String((_ref = (_ref1 = service == null ? void 0 : service.name) != null ? _ref1 : booking.serviceName) != null ? _ref : '').trim();
-        const timezone = (service == null ? void 0 : service.timezone) || undefined;
-        let activityId = null;
-        if (wantsMeeting) {
-            // The per-record ceiling (AGL-2611): a full log refuses the meeting
-            // but not the follow-up — a task is owed either way.
-            const logged = await countCrmActivitiesForRecord(orgRef, record.link);
-            if (crmActivityLogHasRoom(logged)) {
-                const activity = _extends({
-                    kind: 'meeting',
-                    body: crmBookingMeetingBody({
-                        serviceName,
-                        startsAtMs: booking.startsAtMs,
-                        timezone
-                    }),
-                    // When it HAPPENS, which is the slot — not when it was booked.
-                    atMs: booking.startsAtMs,
-                    byUid: ''
-                }, record.link, {
-                    bookingId: booking.id,
-                    hostId,
-                    visibleTo,
-                    createdAt: FieldValue.serverTimestamp(),
-                    updatedAt: FieldValue.serverTimestamp()
-                });
-                const written = await activities.add(activity);
-                activityId = written.id;
-            }
-        }
-        let taskId = null;
-        if (wantsTask) {
-            const task = _extends({
-                title: crmBookingFollowUpTitle(serviceName),
-                kind: 'todo',
-                priority: 'normal',
-                status: 'open',
-                dueAtMs: crmBookingFollowUpDueMs(booking.endsAtMs, timezone)
-            }, record.ownerUid ? {
-                assigneeUid: record.ownerUid
-            } : {}, {
-                createdByUid: ''
-            }, record.link, {
-                hostId,
-                visibleTo,
-                createdAt: FieldValue.serverTimestamp(),
-                updatedAt: FieldValue.serverTimestamp()
-            });
-            // What the Tasks list searches by (AGL-3321), beside the task.
-            const written = await orgRef.collection(CRM_COLLECTIONS.tasks).add(_extends({}, task, crmTaskListFields(task)));
-            taskId = written.id;
-        }
-        return {
-            filed: true,
-            matchedBy: record.matchedBy,
-            link: record.link,
-            activityId,
-            taskId
-        };
-    } catch (error) {
-        console.error('[crm] booking could not be filed', hostId, booking == null ? void 0 : booking.id, error);
-        return {
-            filed: false,
-            reason: 'failed'
-        };
-    }
-}
-
-//# sourceMappingURL=crm-booking-activity.js.map

package/src/lib/server/crm-booking-activity.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../../../../../libs/tenant/data/admin/src/lib/server/crm-booking-activity.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  checkEntitlement,\n  consentGroupForHost,\n  CRM_COLLECTIONS,\n  crmTaskListFields,\n  type CrmActivity,\n  type CrmActivityLink,\n  type CrmTask,\n  crmActivityLogHasRoom,\n  crmBookingFollowUpDueMs,\n  crmBookingFollowUpTitle,\n  crmBookingMeetingBody,\n  crmScopeTokens,\n  isHostPluginEnabled,\n  parseCrmBookingRef,\n  readContactFacet,\n  visibleToHost,\n} from '@aglyn/aglyn/server'\nimport { FieldValue } from 'firebase-admin/firestore'\nimport { findContactByEmail } from './contact-email-index'\nimport { readLeadForHost } from './host-visitor-records'\nimport { countCrmActivitiesForRecord } from './crm-records'\n\n/**\n * WHAT A BOOKING FILES ON THE CRM RECORD (AGL-2660).\n *\n * A confirmed booking is a meeting the record has on its calendar, and the\n * timeline should say so without a rep logging it by hand. So once a\n * booking's row is written — at creation for a free service, on payment\n * for a paid one — the record is found and a `meeting` activity filed under\n * it, with a follow-up task beside it when the service asks for one.\n *\n * ## Which record\n *\n * The reference the booking link carried wins: `crmRef` names the contact,\n * lead or deal the rep dropped the link from, and a booking made through\n * that link belongs to that record even when the booker typed a different\n * address. Without one — a booking taken off the widget cold — the booker's\n * address is looked up through the org's address index, narrowed to this\n * site, exactly as the automation steps resolve an event's contact. A\n * reference to a record the site cannot see, or that no longer exists,\n * falls through to the address rather than filing under nobody.\n *\n * ## Where it lives\n *\n * In the admin library rather than the Bookings plugin, because the row is\n * a CRM record: its scope, its ceiling and its collections are the CRM's,\n * and a plugin that stamped its own would be a second creator to keep in\n * step with `crmScopeTokens`. The Bookings plugin passes what it already\n * holds and reads the outcome; the CRM plugin is never imported.\n *\n * Firestore is a parameter, as in `crm-records.ts`: the callers hold one,\n * and a module that reached for the Admin app itself would drag it into\n * every spec that only wants the arithmetic.\n *\n * ## Failure posture\n *\n * **Never throws.** A booking that could not be filed on the CRM is still\n * a booking — the guest has the slot and the confirmation — so a failure\n * here is logged and reported in the outcome, never raised into the\n * request that took the booking or the webhook that confirmed it.\n */\n\n/** The CRM plugin's id, as `enabledPlugins` and `disabledPlugins` name it. */\nconst CRM_PLUGIN_ID = 'crm'\n\nexport interface CrmBookingRecordInput {\n  hostId: string\n  /**\n   * The owning org, as `getOrgForHost` returns it — the plugin set, the\n   * consent groups and the scope default are all read off it.\n   */\n  org: Record<string, unknown> | null | undefined\n  orgId: string\n  /** The booking as its row was written. */\n  booking: {\n    id: string\n    serviceId?: string\n    serviceName?: string\n    email?: string\n    startsAtMs: number\n    endsAtMs: number\n    /** The `crm` query value the link carried, kept on the row. */\n    crmRef?: string | null\n  }\n  /** The service as stored: its two CRM switches and its timezone. */\n  service:\n    | {\n        name?: string\n        timezone?: string\n        crmFollowUpTask?: boolean\n        crmMeetingActivity?: boolean\n      }\n    | null\n    | undefined\n  /**\n   * The host document's plugin fields, when the caller already holds them;\n   * read here otherwise. The deny-list is per site, and a site that has\n   * switched the CRM off must file nothing.\n   */\n  host?: { disabledPlugins?: string[]; enabledPlugins?: string[] } | null\n}\n\nexport type CrmBookingRecordOutcome =\n  | {\n      filed: false\n      reason:\n        /** The CRM plugin does not run on this site. */\n        | 'crm-off'\n        /**\n         * The org's plan does not carry the CRM suite, whose activities and\n         * tasks these are (AGL-2787).\n         */\n        | 'not-entitled'\n        /** Neither the reference nor the address named a record. */\n        | 'no-record'\n        /** A meeting for this booking is already on the timeline. */\n        | 'already-filed'\n        /** The service asks for neither a meeting nor a follow-up. */\n        | 'nothing-to-file'\n        /** A read or a write threw; logged, and nothing is promised. */\n        | 'failed'\n    }\n  | {\n      filed: true\n      /** How the record was found. */\n      matchedBy: 'crmRef' | 'email'\n      link: CrmActivityLink\n      /** The meeting's id, or `null` when the service files no meeting. */\n      activityId: string | null\n      /** The follow-up's id, or `null` when the service asks for none. */\n      taskId: string | null\n    }\n\ninterface ResolvedRecord {\n  link: CrmActivityLink\n  matchedBy: 'crmRef' | 'email'\n  /** Whoever holds the relationship, for the follow-up's assignee. */\n  ownerUid?: string\n}\n\n/**\n * The record a booking belongs to — the reference first, the address second.\n */\nasync function resolveBookingRecord(\n  firestore: FirebaseFirestore.Firestore,\n  input: CrmBookingRecordInput,\n  groupId: string,\n): Promise<ResolvedRecord | null> {\n  const { hostId, orgId } = input\n  const orgRef = firestore.collection('orgs').doc(orgId)\n  const contactsRef = orgRef.collection('contacts')\n  const ref = parseCrmBookingRef(input.booking.crmRef)\n  if (ref?.kind === 'contact') {\n    const contact = await contactsRef.doc(ref.id).get()\n    if (contact.exists && visibleToHost(contact.get('visibleTo'), hostId)) {\n      const facet = readContactFacet(contact.data() ?? {}, groupId)\n      return {\n        link: {\n          contactId: contact.id,\n          ...(facet.companyId ? { companyId: facet.companyId } : {}),\n        },\n        matchedBy: 'crmRef',\n        ...(facet.ownerUid ? { ownerUid: facet.ownerUid } : {}),\n      }\n    }\n  }\n  if (ref?.kind === 'deal') {\n    const deal = await orgRef.collection(CRM_COLLECTIONS.deals).doc(ref.id).get()\n    if (deal.exists && visibleToHost(deal.get('visibleTo'), hostId)) {\n      const contactId = String(deal.get('contactId') ?? '')\n      const companyId = String(deal.get('companyId') ?? '')\n      const ownerUid = String(deal.get('ownerUid') ?? '')\n      return {\n        link: {\n          dealId: deal.id,\n          ...(contactId ? { contactId } : {}),\n          ...(companyId ? { companyId } : {}),\n        },\n        matchedBy: 'crmRef',\n        ...(ownerUid ? { ownerUid } : {}),\n      }\n    }\n  }\n  if (ref?.kind === 'lead') {\n    /*\n     * A lead carries its own `visibleTo` now (AGL-3275) — it used to be\n     * host-scoped by path, and the comment here said so. The seam reads the\n     * org row, and the site has to be allowed to see it before a booking is\n     * filed against it, or one brand's booking would name another's lead.\n     */\n    const lead = await readLeadForHost(hostId, ref.id)\n    if (lead && visibleToHost(lead.get('visibleTo'), hostId)) {\n      const ownerUid = String(lead.get('ownerUid') ?? '')\n      return {\n        link: { leadId: lead.id },\n        matchedBy: 'crmRef',\n        ...(ownerUid ? { ownerUid } : {}),\n      }\n    }\n  }\n  const hit = await findContactByEmail(contactsRef, input.booking.email, { hostId })\n  if (!hit) return null\n  const facet = readContactFacet(hit.data() ?? {}, groupId)\n  return {\n    link: {\n      contactId: hit.id,\n      ...(facet.companyId ? { companyId: facet.companyId } : {}),\n    },\n    matchedBy: 'email',\n    ...(facet.ownerUid ? { ownerUid: facet.ownerUid } : {}),\n  }\n}\n\n/**\n * Files what a confirmed booking owes the CRM: the meeting, and the\n * follow-up when the service asks for one. See the module comment.\n */\nexport async function recordCrmBooking(\n  firestore: FirebaseFirestore.Firestore,\n  input: CrmBookingRecordInput,\n): Promise<CrmBookingRecordOutcome> {\n  const { hostId, orgId, booking, service } = input\n  try {\n    if (!hostId || !orgId || !booking?.id) return { filed: false, reason: 'failed' }\n    const wantsMeeting = service?.crmMeetingActivity !== false\n    const wantsTask = service?.crmFollowUpTask === true\n    if (!wantsMeeting && !wantsTask) return { filed: false, reason: 'nothing-to-file' }\n\n    const host =\n      input.host === undefined\n        ? ((await firestore.collection('hosts').doc(hostId).get()).data() as\n            | { disabledPlugins?: string[]; enabledPlugins?: string[] }\n            | undefined) ?? null\n        : input.host\n    if (!isHostPluginEnabled(input.org ?? null, host, CRM_PLUGIN_ID)) {\n      return { filed: false, reason: 'crm-off' }\n    }\n    if (!checkEntitlement(input.org as Parameters<typeof checkEntitlement>[0], 'crm')) {\n      return { filed: false, reason: 'not-entitled' }\n    }\n\n    const orgRef = firestore.collection('orgs').doc(orgId)\n    const activities = orgRef.collection(CRM_COLLECTIONS.activities)\n    // One meeting per booking, whatever path re-enters: the paid webhook is\n    // redelivered for days after any 500, and its own guard is the status,\n    // which this row is not part of.\n    const already = await activities.where('bookingId', '==', booking.id).limit(1).get()\n    if (!already.empty) return { filed: false, reason: 'already-filed' }\n\n    const group = consentGroupForHost(input.org ?? null, hostId)\n    const record = await resolveBookingRecord(firestore, input, group.groupId)\n    if (!record) return { filed: false, reason: 'no-record' }\n\n    const visibleTo = crmScopeTokens(input.org ?? null, group)\n    const serviceName = String(service?.name ?? booking.serviceName ?? '').trim()\n    const timezone = service?.timezone || undefined\n\n    let activityId: string | null = null\n    if (wantsMeeting) {\n      // The per-record ceiling (AGL-2611): a full log refuses the meeting\n      // but not the follow-up — a task is owed either way.\n      const logged = await countCrmActivitiesForRecord(orgRef, record.link)\n      if (crmActivityLogHasRoom(logged)) {\n        const activity: CrmActivity = {\n          kind: 'meeting',\n          body: crmBookingMeetingBody({\n            serviceName,\n            startsAtMs: booking.startsAtMs,\n            timezone,\n          }),\n          // When it HAPPENS, which is the slot — not when it was booked.\n          atMs: booking.startsAtMs,\n          byUid: '',\n          ...record.link,\n          bookingId: booking.id,\n          hostId,\n          visibleTo,\n          createdAt: FieldValue.serverTimestamp(),\n          updatedAt: FieldValue.serverTimestamp(),\n        }\n        const written = await activities.add(activity)\n        activityId = written.id\n      }\n    }\n\n    let taskId: string | null = null\n    if (wantsTask) {\n      const task: CrmTask = {\n        title: crmBookingFollowUpTitle(serviceName),\n        kind: 'todo',\n        priority: 'normal',\n        status: 'open',\n        dueAtMs: crmBookingFollowUpDueMs(booking.endsAtMs, timezone),\n        ...(record.ownerUid ? { assigneeUid: record.ownerUid } : {}),\n        createdByUid: '',\n        ...record.link,\n        hostId,\n        visibleTo,\n        createdAt: FieldValue.serverTimestamp(),\n        updatedAt: FieldValue.serverTimestamp(),\n      }\n      // What the Tasks list searches by (AGL-3321), beside the task.\n      const written = await orgRef\n        .collection(CRM_COLLECTIONS.tasks)\n        .add({ ...task, ...crmTaskListFields(task) })\n      taskId = written.id\n    }\n\n    return { filed: true, matchedBy: record.matchedBy, link: record.link, activityId, taskId }\n  } catch (error) {\n    console.error('[crm] booking could not be filed', hostId, booking?.id, error)\n    return { filed: false, reason: 'failed' }\n  }\n}\n"],"names":["checkEntitlement","consentGroupForHost","CRM_COLLECTIONS","crmTaskListFields","crmActivityLogHasRoom","crmBookingFollowUpDueMs","crmBookingFollowUpTitle","crmBookingMeetingBody","crmScopeTokens","isHostPluginEnabled","parseCrmBookingRef","readContactFacet","visibleToHost","FieldValue","findContactByEmail","readLeadForHost","countCrmActivitiesForRecord","CRM_PLUGIN_ID","resolveBookingRecord","firestore","input","groupId","hit","hostId","orgId","orgRef","collection","doc","contactsRef","ref","booking","crmRef","kind","contact","id","get","exists","facet","data","link","contactId","companyId","matchedBy","ownerUid","deal","deals","String","dealId","lead","leadId","email","recordCrmBooking","service","filed","reason","wantsMeeting","crmMeetingActivity","wantsTask","crmFollowUpTask","host","undefined","org","activities","already","where","limit","empty","group","record","visibleTo","serviceName","name","trim","timezone","activityId","logged","activity","body","startsAtMs","atMs","byUid","bookingId","createdAt","serverTimestamp","updatedAt","written","add","taskId","task","title","priority","status","dueAtMs","endsAtMs","assigneeUid","createdByUid","tasks","error","console"],"mappings":"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"}

package/src/lib/server/crm-inbound-email.d.ts

@@ -1,145 +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, type CrmEmailDirection, type CrmInboundCandidate, type CrmInboundMember } from '@aglyn/aglyn/server';
-import type { ReceivedEmail } from '@aglyn/shared-util-email';
-/**
- * EMAIL CAPTURE (AGL-2657): the half with Firestore.
- *
- * The org's capture token — minted once, replaced on a rotation, found
- * again from a message's recipient — and the filing of one received
- * message: which record it was with, whether it has been filed before, and
- * the row it becomes. The pure rules are `@aglyn/aglyn`'s
- * `crm-inbound.ts`; this module is the reads and the one write.
- *
- * Firestore is a parameter throughout, as in `crm-records.ts` and
- * `crm-email-activity.ts`: the routes hold one, and a module that reached
- * for the Admin app itself would drag it into every spec that only wants
- * the matching. The roster is read through that same store by
- * `loadCrmInboundRoster`, and the caller writes the org's feed line, so a
- * spec of this module needs a store and nothing else.
- */
-/** The most candidate addresses one message is matched by. */
-export declare const CRM_INBOUND_CANDIDATE_MAX = 6;
-/** The most sites whose leads are consulted for one message. */
-export declare const CRM_INBOUND_LEAD_HOST_MAX = 50;
-export interface CrmInboundTokenResult {
-    token: string;
-    createdAtMs: number;
-    rotatedAtMs?: number;
-    /** True when this call replaced a token that existed. */
-    rotated: boolean;
-}
-/**
- * The org's capture token, minted the first time anybody asks and kept
- * thereafter; with `rotate`, replaced. A transaction, so two members
- * opening the settings page at once mint one token and not two, and a
- * rotation lands on the token the reader saw.
- */
-export declare function ensureCrmInboundToken(firestore: FirebaseFirestore.Firestore, orgId: string, options?: {
-    rotate?: boolean;
-    nowMs?: number;
-}): Promise<CrmInboundTokenResult>;
-/**
- * The org a capture token names, or `null`. One equality on
- * `crmInbound.token`, which Firestore indexes on its own; a token that is
- * not one by shape is refused before the query, so a malformed local part
- * costs no read.
- */
-export declare function findOrgByCrmInboundToken(firestore: FirebaseFirestore.Firestore, token: unknown): Promise<{
-    orgId: string;
-    org: Record<string, unknown>;
-} | null>;
-/**
- * Every site of the organization, by id, up to the ceiling — the set a
- * message's lead lookup sweeps. One equality on `hosts.orgId`.
- */
-export declare function crmInboundHostIds(firestore: FirebaseFirestore.Firestore, orgId: string): Promise<string[]>;
-/** The record one of a message's addresses resolved to. */
-export interface CrmInboundMatch {
-    email: string;
-    direction: CrmEmailDirection;
-    kind: 'contact' | 'lead';
-    /** Where the row is filed. */
-    link: CrmActivityLink;
-    /** The site the row is stamped with — the record's own. */
-    hostId: string;
-    /** Who may list the row — the record's own tokens. */
-    visibleTo: string[];
-}
-/**
- * The first candidate that is a contact of the org — through the address
- * index, so a merged record's alternate address answers — or a lead on any
- * of its sites. Candidates are tried in the order the rule gave them and
- * the first hit wins; a contact is looked for before a lead at each
- * address, because a converted lead's address is its contact's.
- */
-export declare function matchCrmInboundCorrespondent(firestore: FirebaseFirestore.Firestore, input: {
-    orgId: string;
-    org: Record<string, unknown>;
-    candidates: readonly CrmInboundCandidate[];
-    hostIds: readonly string[];
-}): Promise<CrmInboundMatch | null>;
-/**
- * The workspace's roster as the filer matches against it: the member
- * documents and every member's stored alias document, two reads under the
- * org, reduced by `crmInboundRoster` to each member's sign-in address and
- * the aliases they have confirmed (AGL-2975).
- */
-export declare function loadCrmInboundRoster(firestore: FirebaseFirestore.Firestore, orgId: string): Promise<CrmInboundMember[]>;
-export type CrmInboundFileOutcome = 
-/** A row was written. */
-{
-    outcome: 'filed';
-    activityId: string;
-    match: CrmInboundMatch;
-}
-/** The message had been filed before; nothing written. */
- | {
-    outcome: 'duplicate';
-    activityId: string;
-}
-/** No address on the message is a record of the org; nothing written. */
- | {
-    outcome: 'unmatched';
-    senderDomain: string | null;
-}
-/** The record's activity log is at its ceiling; nothing written. */
- | {
-    outcome: 'ceiling';
-    match: CrmInboundMatch;
-};
-/**
- * Files one received message on the record it was with (AGL-2657).
- *
- * The order is the cost: the candidate rule is arithmetic; the match is
- * the reads that decide everything after it; a message filed before is
- * answered off one read of the row it would write, before the ceiling's
- * aggregate; the ceiling comes last and refuses rather than dropping a row
- * on a full log. The write is a `create`, so two deliveries racing past
- * the read still yield one row. The BODY never leaves this function except
- * as the bounded excerpt in the row.
- */
-export declare function fileCrmInboundEmail(firestore: FirebaseFirestore.Firestore, input: {
-    orgId: string;
-    org: Record<string, unknown>;
-    message: ReceivedEmail;
-    /** The capture domain, so the capture address is never the correspondent. */
-    domain: string;
-    /** The roster, from `loadCrmInboundRoster`: sign-in addresses and confirmed aliases. */
-    members: readonly CrmInboundMember[];
-    hostIds: readonly string[];
-}): Promise<CrmInboundFileOutcome>;