@aglyn/tenant-data-admin 1.0.0-beta.221 → 1.0.0-beta.223

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

@@ -1,148 +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 { CRM_COLLECTIONS, isCrmEmailDeliveryState, nextCrmEmailDeliveryState } from "@aglyn/aglyn/server";
-import { createHash } from "crypto";
-import { FieldValue } from "firebase-admin/firestore";
-/**
- * The activity row a one-to-one email is logged as, on the server side
- * (AGL-2615): where it lives, how it is written, and how the delivery
- * webhook moves its state.
- *
- * Two writers log a sent email — the console's `crm/email-send` route and
- * the `sendEmail` automation step — and one reader advances it, the Resend
- * event webhook. The reader has to find the row from nothing but the tags
- * on the message, so the id is minted BEFORE the send and stamped on it,
- * and the row is written only after the provider accepted the message. A
- * row written first would be an "email" on the timeline for a message that
- * never left.
- *
- * Firestore is a parameter throughout, 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.
- */ /** `orgs/{orgId}/crmActivities/{activityId}`. */ export function crmActivityRef(firestore, orgId, activityId) {
-    return firestore.collection('orgs').doc(orgId).collection(CRM_COLLECTIONS.activities).doc(activityId);
-}
-/**
- * A fresh reference for the row a send is about to earn — `doc()` with no
- * id mints one locally and reads nothing, so the id can ride the message
- * as a tag before anything is written.
- */ export function newCrmActivityRef(firestore, orgId) {
-    return firestore.collection('orgs').doc(orgId).collection(CRM_COLLECTIONS.activities).doc();
-}
-/**
- * Writes the row a sent email is logged as, stamped with the server clock.
- *
- * `set` rather than `add`, because the id was minted ahead of the send and
- * is already on the message; a second id here would be the one the webhook
- * could not find.
- */ export async function writeCrmEmailActivity(ref, activity) {
-    await ref.set(_extends({}, activity, {
-        createdAt: FieldValue.serverTimestamp(),
-        updatedAt: FieldValue.serverTimestamp()
-    }));
-}
-/**
- * Which delivery state one normalized delivery event moves a row to, or
- * `null` for an event that moves nothing.
- *
- * Takes the log's own vocabulary (`EmailDeliveryEventType`) rather than the
- * provider's wire strings: the mail provider's `deliveryEvents` is the one place
- * that reads those, and this module must not become a second. The five
- * states the timeline shows share the log's names exactly, so the mapping
- * is membership; `delayed` and `failed` are the log's own and the row keeps
- * whatever it held.
- */ export function crmEmailDeliveryStateForEvent(type) {
-    return isCrmEmailDeliveryState(type) ? type : null;
-}
-/**
- * One delivery event, onto the activity row it names (AGL-2615).
- *
- * A TRANSACTION, because the rule is "keep the later state" and two events
- * for one message routinely arrive together — `delivered` and `opened`
- * within the same second from a mail client that fetches images on
- * receipt. Two plain read-then-writes interleaved would let the earlier
- * event land last and print "Delivered" over an open that already
- * happened; inside a transaction the second read sees the first write and
- * `nextCrmEmailDeliveryState` answers "unchanged".
- *
- * A row that is not an email activity is left alone: the tag named it, but
- * a delivery state on a call log would be a chip the timeline has no way to
- * explain. **Never throws** — the webhook answers the provider 200 whatever
- * happens here, so a failure is logged and reported rather than raised.
- */ export async function recordCrmEmailDelivery(firestore, input) {
-    var _input_detail;
-    const { orgId, activityId, state } = input;
-    if (!orgId || !activityId) return 'missing';
-    const ref = crmActivityRef(firestore, orgId, activityId);
-    const detail = String((_input_detail = input.detail) != null ? _input_detail : '').replace(/\s+/g, ' ').trim().slice(0, 500);
-    try {
-        return await firestore.runTransaction(async (transaction)=>{
-            const snapshot = await transaction.get(ref);
-            if (!snapshot.exists || snapshot.get('kind') !== 'email') return 'missing';
-            const current = snapshot.get('deliveryState');
-            const next = nextCrmEmailDeliveryState(current, state);
-            if (next === current) return 'unchanged';
-            transaction.update(ref, _extends({
-                deliveryState: next,
-                deliveryAtMs: Number.isFinite(input.atMs) ? input.atMs : Date.now()
-            }, detail ? {
-                deliveryDetail: detail
-            } : {}, {
-                updatedAt: FieldValue.serverTimestamp()
-            }));
-            return 'advanced';
-        });
-    } catch (error) {
-        console.error('[crm] email delivery state write failed', orgId, activityId, error);
-        return 'failed';
-    }
-}
-/**
- * `orgs/{orgId}/crmActivities/{id}` for a CAPTURED message (AGL-2657), with
- * the id derived from the message's key — its `Message-ID`, else the
- * provider's id — so a second delivery of one message addresses the row
- * the first delivery wrote. A hash rather than the key itself, because a
- * `Message-ID` carries `<`, `@` and `/`, which a document id may not.
- */ export function crmCapturedEmailActivityRef(firestore, orgId, key) {
-    const digest = createHash('sha256').update(key).digest('hex').slice(0, 28);
-    return crmActivityRef(firestore, orgId, `cap_${digest}`);
-}
-const isAlreadyExists = (error)=>{
-    var _ref;
-    const failure = error;
-    return (failure == null ? void 0 : failure.code) === 6 || (failure == null ? void 0 : failure.code) === 'already-exists' || /ALREADY_EXISTS/i.test(String((_ref = failure == null ? void 0 : failure.message) != null ? _ref : ''));
-};
-/**
- * Writes a captured message's row ONCE: `create()`, which refuses a
- * document that already exists, is what makes two deliveries of one
- * message one row even when they arrive together — the second create is
- * the one Firestore refuses, and this answers `duplicate` for it. Any
- * other failure is the caller's.
- */ export async function createCrmEmailActivity(ref, activity) {
-    try {
-        await ref.create(_extends({}, activity, {
-            createdAt: FieldValue.serverTimestamp(),
-            updatedAt: FieldValue.serverTimestamp()
-        }));
-        return 'created';
-    } catch (error) {
-        if (isAlreadyExists(error)) return 'duplicate';
-        throw error;
-    }
-}
-
-//# sourceMappingURL=crm-email-activity.js.map

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

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../../../../../libs/tenant/data/admin/src/lib/server/crm-email-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  CRM_COLLECTIONS,\n  type CrmActivity,\n  type CrmEmailDeliveryState,\n  isCrmEmailDeliveryState,\n  nextCrmEmailDeliveryState,\n} from '@aglyn/aglyn/server'\nimport { createHash } from 'crypto'\nimport { FieldValue } from 'firebase-admin/firestore'\n\n/**\n * The activity row a one-to-one email is logged as, on the server side\n * (AGL-2615): where it lives, how it is written, and how the delivery\n * webhook moves its state.\n *\n * Two writers log a sent email — the console's `crm/email-send` route and\n * the `sendEmail` automation step — and one reader advances it, the Resend\n * event webhook. The reader has to find the row from nothing but the tags\n * on the message, so the id is minted BEFORE the send and stamped on it,\n * and the row is written only after the provider accepted the message. A\n * row written first would be an \"email\" on the timeline for a message that\n * never left.\n *\n * Firestore is a parameter throughout, as in `crm-records.ts`: the callers\n * hold one, and a module that reached for the Admin app itself would drag\n * it into every spec that only wants the arithmetic.\n */\n\n/** `orgs/{orgId}/crmActivities/{activityId}`. */\nexport function crmActivityRef(\n  firestore: FirebaseFirestore.Firestore,\n  orgId: string,\n  activityId: string,\n): FirebaseFirestore.DocumentReference {\n  return firestore\n    .collection('orgs')\n    .doc(orgId)\n    .collection(CRM_COLLECTIONS.activities)\n    .doc(activityId)\n}\n\n/**\n * A fresh reference for the row a send is about to earn — `doc()` with no\n * id mints one locally and reads nothing, so the id can ride the message\n * as a tag before anything is written.\n */\nexport function newCrmActivityRef(\n  firestore: FirebaseFirestore.Firestore,\n  orgId: string,\n): FirebaseFirestore.DocumentReference {\n  return firestore\n    .collection('orgs')\n    .doc(orgId)\n    .collection(CRM_COLLECTIONS.activities)\n    .doc()\n}\n\n/**\n * Writes the row a sent email is logged as, stamped with the server clock.\n *\n * `set` rather than `add`, because the id was minted ahead of the send and\n * is already on the message; a second id here would be the one the webhook\n * could not find.\n */\nexport async function writeCrmEmailActivity(\n  ref: FirebaseFirestore.DocumentReference,\n  activity: CrmActivity,\n): Promise<void> {\n  await ref.set({\n    ...activity,\n    createdAt: FieldValue.serverTimestamp(),\n    updatedAt: FieldValue.serverTimestamp(),\n  })\n}\n\n/**\n * Which delivery state one normalized delivery event moves a row to, or\n * `null` for an event that moves nothing.\n *\n * Takes the log's own vocabulary (`EmailDeliveryEventType`) rather than the\n * provider's wire strings: the mail provider's `deliveryEvents` is the one place\n * that reads those, and this module must not become a second. The five\n * states the timeline shows share the log's names exactly, so the mapping\n * is membership; `delayed` and `failed` are the log's own and the row keeps\n * whatever it held.\n */\nexport function crmEmailDeliveryStateForEvent(\n  type: string | null | undefined,\n): CrmEmailDeliveryState | null {\n  return isCrmEmailDeliveryState(type) ? type : null\n}\n\nexport type CrmEmailDeliveryOutcome =\n  /** The row moved to the incoming state. */\n  | 'advanced'\n  /** The row already held this state or a later one; nothing written. */\n  | 'unchanged'\n  /** No email activity by that id in that org; nothing written. */\n  | 'missing'\n  /** The read or the write threw; logged, and nothing is promised. */\n  | 'failed'\n\n/**\n * One delivery event, onto the activity row it names (AGL-2615).\n *\n * A TRANSACTION, because the rule is \"keep the later state\" and two events\n * for one message routinely arrive together — `delivered` and `opened`\n * within the same second from a mail client that fetches images on\n * receipt. Two plain read-then-writes interleaved would let the earlier\n * event land last and print \"Delivered\" over an open that already\n * happened; inside a transaction the second read sees the first write and\n * `nextCrmEmailDeliveryState` answers \"unchanged\".\n *\n * A row that is not an email activity is left alone: the tag named it, but\n * a delivery state on a call log would be a chip the timeline has no way to\n * explain. **Never throws** — the webhook answers the provider 200 whatever\n * happens here, so a failure is logged and reported rather than raised.\n */\nexport async function recordCrmEmailDelivery(\n  firestore: FirebaseFirestore.Firestore,\n  input: {\n    orgId: string\n    activityId: string\n    state: CrmEmailDeliveryState\n    /** When the provider says it happened, epoch ms. */\n    atMs: number\n    /**\n     * What the receiving server said (AGL-3245), for a failure: the bounce's\n     * diagnostic, scrubbed of the address. Kept beside the state as\n     * `deliveryDetail`, so the timeline can say why the message did not land.\n     */\n    detail?: string | null\n  },\n): Promise<CrmEmailDeliveryOutcome> {\n  const { orgId, activityId, state } = input\n  if (!orgId || !activityId) return 'missing'\n  const ref = crmActivityRef(firestore, orgId, activityId)\n  const detail = String(input.detail ?? '').replace(/\\s+/g, ' ').trim().slice(0, 500)\n  try {\n    return await firestore.runTransaction(async (transaction) => {\n      const snapshot = await transaction.get(ref)\n      if (!snapshot.exists || snapshot.get('kind') !== 'email') return 'missing'\n      const current = snapshot.get('deliveryState')\n      const next = nextCrmEmailDeliveryState(current, state)\n      if (next === current) return 'unchanged'\n      transaction.update(ref, {\n        deliveryState: next,\n        deliveryAtMs: Number.isFinite(input.atMs) ? input.atMs : Date.now(),\n        ...(detail ? { deliveryDetail: detail } : {}),\n        updatedAt: FieldValue.serverTimestamp(),\n      })\n      return 'advanced'\n    })\n  } catch (error) {\n    console.error('[crm] email delivery state write failed', orgId, activityId, error)\n    return 'failed'\n  }\n}\n\n/**\n * `orgs/{orgId}/crmActivities/{id}` for a CAPTURED message (AGL-2657), with\n * the id derived from the message's key — its `Message-ID`, else the\n * provider's id — so a second delivery of one message addresses the row\n * the first delivery wrote. A hash rather than the key itself, because a\n * `Message-ID` carries `<`, `@` and `/`, which a document id may not.\n */\nexport function crmCapturedEmailActivityRef(\n  firestore: FirebaseFirestore.Firestore,\n  orgId: string,\n  key: string,\n): FirebaseFirestore.DocumentReference {\n  const digest = createHash('sha256').update(key).digest('hex').slice(0, 28)\n  return crmActivityRef(firestore, orgId, `cap_${digest}`)\n}\n\n/** What a create answered: the row is new, or it was already there. */\nexport type CrmEmailActivityCreateOutcome = 'created' | 'duplicate'\n\nconst isAlreadyExists = (error: unknown): boolean => {\n  const failure = error as { code?: unknown; message?: unknown } | null\n  return (\n    failure?.code === 6 ||\n    failure?.code === 'already-exists' ||\n    /ALREADY_EXISTS/i.test(String(failure?.message ?? ''))\n  )\n}\n\n/**\n * Writes a captured message's row ONCE: `create()`, which refuses a\n * document that already exists, is what makes two deliveries of one\n * message one row even when they arrive together — the second create is\n * the one Firestore refuses, and this answers `duplicate` for it. Any\n * other failure is the caller's.\n */\nexport async function createCrmEmailActivity(\n  ref: FirebaseFirestore.DocumentReference,\n  activity: CrmActivity,\n): Promise<CrmEmailActivityCreateOutcome> {\n  try {\n    await ref.create({\n      ...activity,\n      createdAt: FieldValue.serverTimestamp(),\n      updatedAt: FieldValue.serverTimestamp(),\n    })\n    return 'created'\n  } catch (error) {\n    if (isAlreadyExists(error)) return 'duplicate'\n    throw error\n  }\n}\n"],"names":["CRM_COLLECTIONS","isCrmEmailDeliveryState","nextCrmEmailDeliveryState","createHash","FieldValue","crmActivityRef","firestore","orgId","activityId","collection","doc","activities","newCrmActivityRef","writeCrmEmailActivity","ref","activity","set","createdAt","serverTimestamp","updatedAt","crmEmailDeliveryStateForEvent","type","recordCrmEmailDelivery","input","state","detail","String","replace","trim","slice","runTransaction","transaction","snapshot","get","exists","current","next","update","deliveryState","deliveryAtMs","Number","isFinite","atMs","Date","now","deliveryDetail","error","console","crmCapturedEmailActivityRef","key","digest","isAlreadyExists","failure","code","test","message","createCrmEmailActivity","create"],"mappings":"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"}

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

@@ -1,74 +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 CrmNextActivityLink, type CrmNextActivityLinkField } from '@aglyn/aglyn/app-utils/crm-next-activity';
-/** The collection each link field's record lives in, under `orgs/{orgId}/`. */
-export declare const CRM_NEXT_ACTIVITY_COLLECTIONS: Readonly<Record<CrmNextActivityLinkField, string>>;
-export interface CrmNextActivityRecompute {
-    /** Records whose stored value was written (or rewritten to the same figure). */
-    records: number;
-    /** Records that no longer exist — a task can outlive what it was filed against. */
-    missing: number;
-}
-/**
- * Recompute `nextTaskAtMs` for every record the links name, once each.
- *
- * Hand in BOTH sides of a change — the links a task carried before an
- * update and the ones it carries after — so a task moved from one deal to
- * another leaves neither stale. A record the task named that has since been
- * deleted is counted in `missing` and skipped; nothing here creates one.
- */
-export declare function recomputeCrmNextTaskAt(firestore: FirebaseFirestore.Firestore, orgId: string, links: readonly (CrmNextActivityLink | null | undefined)[]): Promise<CrmNextActivityRecompute>;
-/**
- * The same, from a task document rather than a link — what a writer holds
- * after it has read the task it is about to change or has just changed.
- */
-export declare function crmNextActivityLinksOf(task: Record<string, unknown> | null | undefined): CrmNextActivityLink;
-/** The most open tasks one org-wide recompute walks. */
-export declare const CRM_NEXT_ACTIVITY_SWEEP_MAX = 20000;
-export interface CrmNextActivitySweep {
-    /** Open tasks read. */
-    tasks: number;
-    /** Records that now carry a time. */
-    scheduled: number;
-    /** Records that carried a time and now carry `null`. */
-    cleared: number;
-    /** Whether the org held more open tasks than the sweep reads. */
-    truncated: boolean;
-}
-/**
- * The one-off recompute for a whole organization — the Fields section's
- * "Recompute next activity" (AGL-2661), for the records written before the
- * field existed and for whatever a client-direct write left behind.
- *
- * Two passes and no per-record task query: every OPEN task once, grouped
- * by the records it names, so each record with something scheduled is
- * written its earliest due time; then every record in the three
- * collections that CARRIES a time and was not in that group, cleared to
- * `null`. A record that was never written is left alone — every reader
- * already treats absent as `null`, and writing a null onto every contact
- * an org holds would cost a write per person to say nothing.
- *
- * The clearing pass runs only when the first pass read EVERY open task.
- * "No open task names this record" is a statement about all of them, and
- * an organization holding more than the cap has open tasks the sweep never
- * saw — clearing on a partial read would blank records that are perfectly
- * scheduled. Past the cap the sweep is the writing half alone, and
- * `truncated` says so.
- */
-export declare function sweepCrmNextTaskAt(firestore: FirebaseFirestore.Firestore, orgId: string, options?: {
-    max?: number;
-}): Promise<CrmNextActivitySweep>;

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

@@ -1,194 +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.
- */ /**
- * The `nextTaskAtMs` a record carries, as the Admin SDK writes it (AGL-2661).
- *
- * A contact, a company and a deal each denormalize when their earliest OPEN
- * task is due, so a list can draw a "Next activity" column and answer
- * "which deals have nothing scheduled" without a task query per row. This
- * is the writer: given the records a task names, read that record's tasks
- * back and store the answer `nextTaskAtMsOf` gives. Every server-side task
- * writer — the console's task routes, the REST resource, the workflow step
- * that files a task, the merge that repoints one — calls it after its own
- * write; a client-direct task write asks the console's `crm/next-activity`
- * route, which calls it too.
- *
- * Imported by module path rather than from the `@aglyn/aglyn/server`
- * barrel, for the reason `contact-company-link.ts` gives.
- *
- * The task query is ONE equality on the link field, the query the record
- * cards already run, and the status is judged in memory — no composite
- * index, and a record with a hundred done tasks reads a hundred small
- * documents once per write against it, which is the price of never being
- * wrong. The record write is a bare `update()` of the one field, so
- * `updatedAt` stays where the person's last edit left it: a task moving is
- * not the record being edited, and the lists order by `updatedAt`.
- */ import { CRM_COLLECTIONS } from "@aglyn/aglyn/app-utils/crm";
-import { CRM_NEXT_ACTIVITY_FIELD, mergeNextActivityLinks, nextActivityLinksOfTask, nextTaskAtMsOf, readNextTaskAtMs } from "@aglyn/aglyn/app-utils/crm-next-activity";
-/** The collection each link field's record lives in, under `orgs/{orgId}/`. */ export const CRM_NEXT_ACTIVITY_COLLECTIONS = {
-    contactId: 'contacts',
-    companyId: CRM_COLLECTIONS.companies,
-    dealId: CRM_COLLECTIONS.deals
-};
-const isNotFound = (error)=>{
-    const { code, message } = error != null ? error : {};
-    return code === 5 || code === 'not-found' || code === 'NOT_FOUND' || typeof message === 'string' && message.includes('NOT_FOUND');
-};
-/**
- * Store one record's `nextTaskAtMs` from its tasks. `null` for a record
- * that no longer exists, else the value written.
- */ async function recomputeOne(orgRef, field, id) {
-    const tasks = await orgRef.collection(CRM_COLLECTIONS.tasks).where(field, '==', id).get();
-    const value = nextTaskAtMsOf(tasks.docs.map((doc)=>({
-            status: doc.get('status'),
-            dueAtMs: doc.get('dueAtMs')
-        })));
-    try {
-        await orgRef.collection(CRM_NEXT_ACTIVITY_COLLECTIONS[field]).doc(id).update({
-            [CRM_NEXT_ACTIVITY_FIELD]: value
-        });
-    } catch (error) {
-        if (isNotFound(error)) return {
-            written: false
-        };
-        throw error;
-    }
-    return {
-        written: true,
-        value
-    };
-}
-/**
- * Recompute `nextTaskAtMs` for every record the links name, once each.
- *
- * Hand in BOTH sides of a change — the links a task carried before an
- * update and the ones it carries after — so a task moved from one deal to
- * another leaves neither stale. A record the task named that has since been
- * deleted is counted in `missing` and skipped; nothing here creates one.
- */ export async function recomputeCrmNextTaskAt(firestore, orgId, links) {
-    const orgRef = firestore.collection('orgs').doc(orgId);
-    const result = {
-        records: 0,
-        missing: 0
-    };
-    for (const { field, id } of mergeNextActivityLinks(links)){
-        const outcome = await recomputeOne(orgRef, field, id);
-        if (outcome.written) result.records += 1;
-        else result.missing += 1;
-    }
-    return result;
-}
-/**
- * The same, from a task document rather than a link — what a writer holds
- * after it has read the task it is about to change or has just changed.
- */ export function crmNextActivityLinksOf(task) {
-    return nextActivityLinksOfTask(task);
-}
-/** The most open tasks one org-wide recompute walks. */ export const CRM_NEXT_ACTIVITY_SWEEP_MAX = 20000;
-/**
- * The one-off recompute for a whole organization — the Fields section's
- * "Recompute next activity" (AGL-2661), for the records written before the
- * field existed and for whatever a client-direct write left behind.
- *
- * Two passes and no per-record task query: every OPEN task once, grouped
- * by the records it names, so each record with something scheduled is
- * written its earliest due time; then every record in the three
- * collections that CARRIES a time and was not in that group, cleared to
- * `null`. A record that was never written is left alone — every reader
- * already treats absent as `null`, and writing a null onto every contact
- * an org holds would cost a write per person to say nothing.
- *
- * The clearing pass runs only when the first pass read EVERY open task.
- * "No open task names this record" is a statement about all of them, and
- * an organization holding more than the cap has open tasks the sweep never
- * saw — clearing on a partial read would blank records that are perfectly
- * scheduled. Past the cap the sweep is the writing half alone, and
- * `truncated` says so.
- */ export async function sweepCrmNextTaskAt(firestore, orgId, options = {}) {
-    var _options_max;
-    const max = (_options_max = options.max) != null ? _options_max : CRM_NEXT_ACTIVITY_SWEEP_MAX;
-    const orgRef = firestore.collection('orgs').doc(orgId);
-    const open = await orgRef.collection(CRM_COLLECTIONS.tasks).where('status', '==', 'open').limit(max + 1).get();
-    const truncated = open.docs.length > max;
-    const docs = open.docs.slice(0, max);
-    const earliest = new Map();
-    for (const field of Object.keys(CRM_NEXT_ACTIVITY_COLLECTIONS)){
-        earliest.set(field, new Map());
-    }
-    for (const doc of docs){
-        const task = {
-            status: doc.get('status'),
-            dueAtMs: doc.get('dueAtMs')
-        };
-        const links = nextActivityLinksOfTask({
-            contactId: doc.get('contactId'),
-            companyId: doc.get('companyId'),
-            dealId: doc.get('dealId')
-        });
-        for (const { field, id } of mergeNextActivityLinks([
-            links
-        ])){
-            var _byId_get;
-            const byId = earliest.get(field);
-            byId.set(id, nextTaskAtMsOf([
-                task,
-                {
-                    status: 'open',
-                    dueAtMs: (_byId_get = byId.get(id)) != null ? _byId_get : null
-                }
-            ]));
-        }
-    }
-    const sweep = {
-        tasks: docs.length,
-        scheduled: 0,
-        cleared: 0,
-        truncated
-    };
-    for (const [field, byId] of earliest){
-        const records = orgRef.collection(CRM_NEXT_ACTIVITY_COLLECTIONS[field]);
-        for (const [id, value] of byId){
-            try {
-                await records.doc(id).update({
-                    [CRM_NEXT_ACTIVITY_FIELD]: value
-                });
-                sweep.scheduled += 1;
-            } catch (error) {
-                if (!isNotFound(error)) throw error;
-            }
-        }
-        /*
-     * The stale half: a record that says something is scheduled when no
-     * open task names it any more. `> 0` is the one query a stored time
-     * answers without an index of its own, and matches what
-     * `readNextTaskAtMs` calls a usable value.
-     */ if (truncated) continue;
-        const carrying = await records.where(CRM_NEXT_ACTIVITY_FIELD, '>', 0).get();
-        for (const doc of carrying.docs){
-            if (byId.has(doc.id)) continue;
-            if (readNextTaskAtMs({
-                nextTaskAtMs: doc.get(CRM_NEXT_ACTIVITY_FIELD)
-            }) === null) continue;
-            await doc.ref.update({
-                [CRM_NEXT_ACTIVITY_FIELD]: null
-            });
-            sweep.cleared += 1;
-        }
-    }
-    return sweep;
-}
-
-//# sourceMappingURL=crm-next-activity.js.map

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

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../../../../../libs/tenant/data/admin/src/lib/server/crm-next-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\n/**\n * The `nextTaskAtMs` a record carries, as the Admin SDK writes it (AGL-2661).\n *\n * A contact, a company and a deal each denormalize when their earliest OPEN\n * task is due, so a list can draw a \"Next activity\" column and answer\n * \"which deals have nothing scheduled\" without a task query per row. This\n * is the writer: given the records a task names, read that record's tasks\n * back and store the answer `nextTaskAtMsOf` gives. Every server-side task\n * writer — the console's task routes, the REST resource, the workflow step\n * that files a task, the merge that repoints one — calls it after its own\n * write; a client-direct task write asks the console's `crm/next-activity`\n * route, which calls it too.\n *\n * Imported by module path rather than from the `@aglyn/aglyn/server`\n * barrel, for the reason `contact-company-link.ts` gives.\n *\n * The task query is ONE equality on the link field, the query the record\n * cards already run, and the status is judged in memory — no composite\n * index, and a record with a hundred done tasks reads a hundred small\n * documents once per write against it, which is the price of never being\n * wrong. The record write is a bare `update()` of the one field, so\n * `updatedAt` stays where the person's last edit left it: a task moving is\n * not the record being edited, and the lists order by `updatedAt`.\n */\n\nimport { CRM_COLLECTIONS } from '@aglyn/aglyn/app-utils/crm'\nimport {\n  CRM_NEXT_ACTIVITY_FIELD,\n  type CrmNextActivityLink,\n  type CrmNextActivityLinkField,\n  mergeNextActivityLinks,\n  nextActivityLinksOfTask,\n  nextTaskAtMsOf,\n  readNextTaskAtMs,\n} from '@aglyn/aglyn/app-utils/crm-next-activity'\n\n/** The collection each link field's record lives in, under `orgs/{orgId}/`. */\nexport const CRM_NEXT_ACTIVITY_COLLECTIONS: Readonly<Record<CrmNextActivityLinkField, string>> = {\n  contactId: 'contacts',\n  companyId: CRM_COLLECTIONS.companies,\n  dealId: CRM_COLLECTIONS.deals,\n}\n\nexport interface CrmNextActivityRecompute {\n  /** Records whose stored value was written (or rewritten to the same figure). */\n  records: number\n  /** Records that no longer exist — a task can outlive what it was filed against. */\n  missing: number\n}\n\nconst isNotFound = (error: unknown): boolean => {\n  const { code, message } = (error ?? {}) as { code?: unknown; message?: unknown }\n  return (\n    code === 5 ||\n    code === 'not-found' ||\n    code === 'NOT_FOUND' ||\n    (typeof message === 'string' && message.includes('NOT_FOUND'))\n  )\n}\n\n/**\n * Store one record's `nextTaskAtMs` from its tasks. `null` for a record\n * that no longer exists, else the value written.\n */\nasync function recomputeOne(\n  orgRef: FirebaseFirestore.DocumentReference,\n  field: CrmNextActivityLinkField,\n  id: string,\n): Promise<{ written: true; value: number | null } | { written: false }> {\n  const tasks = await orgRef\n    .collection(CRM_COLLECTIONS.tasks)\n    .where(field, '==', id)\n    .get()\n  const value = nextTaskAtMsOf(\n    tasks.docs.map((doc) => ({\n      status: doc.get('status'),\n      dueAtMs: doc.get('dueAtMs'),\n    })),\n  )\n  try {\n    await orgRef\n      .collection(CRM_NEXT_ACTIVITY_COLLECTIONS[field])\n      .doc(id)\n      .update({ [CRM_NEXT_ACTIVITY_FIELD]: value })\n  } catch (error) {\n    if (isNotFound(error)) return { written: false }\n    throw error\n  }\n  return { written: true, value }\n}\n\n/**\n * Recompute `nextTaskAtMs` for every record the links name, once each.\n *\n * Hand in BOTH sides of a change — the links a task carried before an\n * update and the ones it carries after — so a task moved from one deal to\n * another leaves neither stale. A record the task named that has since been\n * deleted is counted in `missing` and skipped; nothing here creates one.\n */\nexport async function recomputeCrmNextTaskAt(\n  firestore: FirebaseFirestore.Firestore,\n  orgId: string,\n  links: readonly (CrmNextActivityLink | null | undefined)[],\n): Promise<CrmNextActivityRecompute> {\n  const orgRef = firestore.collection('orgs').doc(orgId)\n  const result: CrmNextActivityRecompute = { records: 0, missing: 0 }\n  for (const { field, id } of mergeNextActivityLinks(links)) {\n    const outcome = await recomputeOne(orgRef, field, id)\n    if (outcome.written) result.records += 1\n    else result.missing += 1\n  }\n  return result\n}\n\n/**\n * The same, from a task document rather than a link — what a writer holds\n * after it has read the task it is about to change or has just changed.\n */\nexport function crmNextActivityLinksOf(\n  task: Record<string, unknown> | null | undefined,\n): CrmNextActivityLink {\n  return nextActivityLinksOfTask(task as Parameters<typeof nextActivityLinksOfTask>[0])\n}\n\n/** The most open tasks one org-wide recompute walks. */\nexport const CRM_NEXT_ACTIVITY_SWEEP_MAX = 20_000\n\nexport interface CrmNextActivitySweep {\n  /** Open tasks read. */\n  tasks: number\n  /** Records that now carry a time. */\n  scheduled: number\n  /** Records that carried a time and now carry `null`. */\n  cleared: number\n  /** Whether the org held more open tasks than the sweep reads. */\n  truncated: boolean\n}\n\n/**\n * The one-off recompute for a whole organization — the Fields section's\n * \"Recompute next activity\" (AGL-2661), for the records written before the\n * field existed and for whatever a client-direct write left behind.\n *\n * Two passes and no per-record task query: every OPEN task once, grouped\n * by the records it names, so each record with something scheduled is\n * written its earliest due time; then every record in the three\n * collections that CARRIES a time and was not in that group, cleared to\n * `null`. A record that was never written is left alone — every reader\n * already treats absent as `null`, and writing a null onto every contact\n * an org holds would cost a write per person to say nothing.\n *\n * The clearing pass runs only when the first pass read EVERY open task.\n * \"No open task names this record\" is a statement about all of them, and\n * an organization holding more than the cap has open tasks the sweep never\n * saw — clearing on a partial read would blank records that are perfectly\n * scheduled. Past the cap the sweep is the writing half alone, and\n * `truncated` says so.\n */\nexport async function sweepCrmNextTaskAt(\n  firestore: FirebaseFirestore.Firestore,\n  orgId: string,\n  options: { max?: number } = {},\n): Promise<CrmNextActivitySweep> {\n  const max = options.max ?? CRM_NEXT_ACTIVITY_SWEEP_MAX\n  const orgRef = firestore.collection('orgs').doc(orgId)\n  const open = await orgRef\n    .collection(CRM_COLLECTIONS.tasks)\n    .where('status', '==', 'open')\n    .limit(max + 1)\n    .get()\n  const truncated = open.docs.length > max\n  const docs = open.docs.slice(0, max)\n\n  const earliest = new Map<CrmNextActivityLinkField, Map<string, number | null>>()\n  for (const field of Object.keys(CRM_NEXT_ACTIVITY_COLLECTIONS) as CrmNextActivityLinkField[]) {\n    earliest.set(field, new Map())\n  }\n  for (const doc of docs) {\n    const task = { status: doc.get('status'), dueAtMs: doc.get('dueAtMs') }\n    const links = nextActivityLinksOfTask({\n      contactId: doc.get('contactId'),\n      companyId: doc.get('companyId'),\n      dealId: doc.get('dealId'),\n    })\n    for (const { field, id } of mergeNextActivityLinks([links])) {\n      const byId = earliest.get(field) as Map<string, number | null>\n      byId.set(id, nextTaskAtMsOf([task, { status: 'open', dueAtMs: byId.get(id) ?? null }]))\n    }\n  }\n\n  const sweep: CrmNextActivitySweep = { tasks: docs.length, scheduled: 0, cleared: 0, truncated }\n  for (const [field, byId] of earliest) {\n    const records = orgRef.collection(CRM_NEXT_ACTIVITY_COLLECTIONS[field])\n    for (const [id, value] of byId) {\n      try {\n        await records.doc(id).update({ [CRM_NEXT_ACTIVITY_FIELD]: value })\n        sweep.scheduled += 1\n      } catch (error) {\n        if (!isNotFound(error)) throw error\n      }\n    }\n    /*\n     * The stale half: a record that says something is scheduled when no\n     * open task names it any more. `> 0` is the one query a stored time\n     * answers without an index of its own, and matches what\n     * `readNextTaskAtMs` calls a usable value.\n     */\n    if (truncated) continue\n    const carrying = await records.where(CRM_NEXT_ACTIVITY_FIELD, '>', 0).get()\n    for (const doc of carrying.docs) {\n      if (byId.has(doc.id)) continue\n      if (readNextTaskAtMs({ nextTaskAtMs: doc.get(CRM_NEXT_ACTIVITY_FIELD) }) === null) continue\n      await doc.ref.update({ [CRM_NEXT_ACTIVITY_FIELD]: null })\n      sweep.cleared += 1\n    }\n  }\n  return sweep\n}\n"],"names":["CRM_COLLECTIONS","CRM_NEXT_ACTIVITY_FIELD","mergeNextActivityLinks","nextActivityLinksOfTask","nextTaskAtMsOf","readNextTaskAtMs","CRM_NEXT_ACTIVITY_COLLECTIONS","contactId","companyId","companies","dealId","deals","isNotFound","error","code","message","includes","recomputeOne","orgRef","field","id","tasks","collection","where","get","value","docs","map","doc","status","dueAtMs","update","written","recomputeCrmNextTaskAt","firestore","orgId","links","result","records","missing","outcome","crmNextActivityLinksOf","task","CRM_NEXT_ACTIVITY_SWEEP_MAX","sweepCrmNextTaskAt","options","max","open","limit","truncated","length","slice","earliest","Map","Object","keys","set","byId","sweep","scheduled","cleared","carrying","has","nextTaskAtMs","ref"],"mappings":"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"}

package/src/lib/server/dataset-live-pages.d.ts

@@ -1,179 +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 { Firestore } from 'firebase-admin/firestore';
-import { type UsageSources } from './live-page-usage';
-/**
- * How many documents per collection the per-site scan reads.
- *
- * The console's publish scan uses the same number for the same reason
- * (AGL-1161): this decides which caches get dropped, so a prefix scan would
- * report a refreshed site and leave real pages serving the old rows. Bounded
- * all the same, and when the bound bites it is SAID rather than absorbed.
- */
-export declare const DATASET_SCAN_LIMIT = 2000;
-/**
- * How many sites one record write fans out to.
- *
- * `MAX_SCOPE_HOSTS` is the ceiling on a NAMED selection, so only an org-wide
- * dataset can reach this — an org with more sites than this pays a scan per
- * site on every write otherwise, which is a cost the person writing one row
- * did not ask for. Sites past the cap keep the TTL they had before this
- * existed, and the shortfall is returned and logged rather than swallowed.
- */
-export declare const MAX_DATASET_FANOUT_HOSTS = 30;
-/**
- * How long one site-and-dataset pair waits before announcing again.
- *
- * A 1,000-row import is one announce because the importer announces after its
- * loop, not per row. This covers the other burst — many small writes arriving
- * separately, a form under load or an automation fanning out — where each one
- * would otherwise pay a full scan per site and hand the tenant the same path
- * list again.
- *
- * Leading edge, so the FIRST write of a burst refreshes immediately; what is
- * skipped is a repeat inside the window, and the next write after it announces
- * again. The cost of the skip is bounded by the window: a row written during
- * one is visible no later than the next announce.
- */
-export declare const DATASET_ANNOUNCE_WINDOW_MS = 2000;
-/** Test seam: the window is process-wide state, so a spec has to reset it. */
-export declare function resetDatasetAnnounceThrottle(): void;
-/** One site's share of a dataset change. */
-export interface DatasetLivePageTarget {
-    hostId: string;
-    /** The tenant keys its cache on this, never on `hostId`. */
-    subdomain: string;
-    /** The attached custom domain, whose pages live under a second cache key. */
-    cname?: string;
-    /** Site-absolute addresses (`/`, `/team`) that repeat over the dataset. */
-    paths: string[];
-    /** The site held more documents than the scan read, so `paths` is partial. */
-    truncated: boolean;
-}
-export interface DatasetLivePageScope {
-    targets: DatasetLivePageTarget[];
-    /**
-     * Sites the fan-out cap left out. Zero in the ordinary case, and reported
-     * rather than logged because a caller that says "refreshed" while some sites
-     * were skipped is the failure this whole arc exists to remove.
-     */
-    hostsDropped: number;
-    /**
-     * Why there is nothing to announce, or `'ok'`.
-     *
-     * `'not-rendered'` is a success: a dataset no page repeats over has no live
-     * page to refresh. It is kept apart from `'error'` for the same reason the
-     * revalidate route keeps `not-routed` apart from a refusal — one means there
-     * was nothing to do, the other means something was left stale.
-     */
-    reason: 'ok' | 'no-dataset' | 'no-sites' | 'not-rendered' | 'error';
-}
-/**
- * Every live screen whose rendered output repeats over the dataset, however
- * indirectly.
- *
- * The same three-bucket closure a placed form's pages are found by, for the
- * same reason: a binding is found by SEARCHING node trees rather than by
- * matching a pointer, so it can sit on the screen, in the chrome of the layout
- * the screen renders inside, or inside a reusable component a third component
- * nests. After the first level the fan-out is identical, so it is delegated
- * rather than restated.
- *
- * Pure, and separate from the Firestore read, so the closure is testable
- * without a database.
- */
-export declare function screenIdsRepeatingDataset(keys: ReadonlySet<string>, sources: UsageSources): string[];
-/**
- * Every live page a change to this dataset's records makes stale, per site.
- *
- * Reads only; announcing is the caller's, because the two runtimes announce
- * differently — the console posts to the tenant over the shared secret, and
- * the tenant drops its own caches in process. Splitting it here is what lets
- * both use one answer to the question of WHICH pages.
- *
- * Never throws. A scope that could not be computed is a scope of nothing, and
- * the TTL underneath is unaffected.
- */
-export declare function datasetLivePageScope(options: {
-    firestore: Firestore;
-    orgId: string;
-    datasetId: string;
-}): Promise<DatasetLivePageScope>;
-/**
- * How one runtime drops a site's cached pages.
- *
- * The generic seam, registered by the deployment that owns the caches. The
- * tenant registers an in-process drop at boot; the console announces over the
- * shared secret and passes its own dropper at the call site. Core names
- * neither, exactly as it names no repeat source.
- *
- * Returns whether the drop landed. It must never throw: everything above it
- * has already been written.
- */
-export type LivePageDropper = (target: DatasetLivePageTarget) => Promise<boolean>;
-/**
- * Registers the dropper for this process, replacing any previous one. Returns
- * the unregister, which removes it only if it is still the one registered.
- *
- * Called from a function the platform calls BY NAME at boot, never from a
- * module's top level: a bundler deletes a module imported only for its side
- * effect when its package says it has none (AGL-3025).
- */
-export declare function registerLivePageDropper(drop: LivePageDropper): () => void;
-export interface DatasetAnnounceResult {
-    /** Sites whose cached pages were dropped. */
-    sitesRefreshed: number;
-    /** Pages named across those sites. */
-    pathsRefreshed: number;
-    /** Sites the drop was attempted on and refused. */
-    sitesRefused: number;
-    /** Sites past the fan-out cap, and sites whose scan was truncated. */
-    hostsDropped: number;
-    scanTruncated: boolean;
-    /** `'throttled'` when a drop for this pair already went out just now. */
-    reason: DatasetLivePageScope['reason'] | 'throttled' | 'no-dropper';
-}
-/**
- * Refresh every live page that shows this dataset's records.
- *
- * The one call a write path makes. BEST EFFORT, ALWAYS: it never throws and
- * never rejects, so a caller can `await` it inside the try that already guards
- * the write without any chance of turning a stored record into a failed one.
- *
- * `drop` overrides the registered dropper for callers that hold their own —
- * the console, whose announce is an authenticated request rather than a local
- * cache call.
- */
-export declare function announceDatasetRecordChange(options: {
-    firestore: Firestore;
-    orgId: string;
-    datasetId: string;
-    drop?: LivePageDropper;
-}): Promise<DatasetAnnounceResult>;
-/**
- * One sentence for a refresh that did not cover every page, or `null` when it
- * did.
- *
- * Beside the call rather than at each surface, so the console cannot word this
- * differently in two places — the same reason `describeRevalidateShortfall`
- * lives beside `revalidateLivePages`. `lead` names the act that succeeded,
- * because only that word differs between surfaces: a record is SAVED, and
- * telling someone who fixed a typo that they published it is a worse error
- * than the staleness the sentence is about.
- */
-export declare function describeDatasetAnnounceShortfall(result: DatasetAnnounceResult | null, lead?: string): string | null;
-export default announceDatasetRecordChange;