@aglyn/plugins-crm 1.0.0-beta.217 → 1.0.0-beta.219

package/src/lib/server/api-v1/crm-tasks.js

@@ -0,0 +1,398 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { _ as _object_without_properties_loose } from "@swc/helpers/_/_object_without_properties_loose";
+/**
+ * @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.
+ */ /**
+ * `/v1/tasks` (AGL-2606) — what the team owes a person: a call, an email, a
+ * meeting or a to-do, with a due date, pointing at the contact, company or
+ * deal it is for. A task may point at nothing — a plain to-do is still a
+ * task — which is the one place it differs from an activity.
+ *
+ * `status` is the only state machine here and it has two states. Marking a
+ * task `done` stamps `completedAtMs`; marking it `open` again clears it, so
+ * a reopened task never reads as completed on the date it was first closed.
+ *
+ * `remindAt` (AGL-2659) is the task's reminder: the due time unless the
+ * body names a time or `null`, carried along when a moved due date leaves
+ * it behind, and cleared by completion while it is still owed — the rule
+ * in `crmTaskReminderAfterEdit`, the same one the console's drawer keeps.
+ * `reminderSentAt` is read-only: when the hourly runner handled it.
+ */ import { CRM_COLLECTIONS, crmTaskReminderAfterEdit, crmTaskReminderPending, createResourceUid, crmTaskListFields } from "@aglyn/aglyn/server";
+import { apiJson, ApiErrors, crmNextActivityLinksOf, recomputeCrmNextTaskAt, restampCrmListFieldsAt } from "@aglyn/tenant-data-admin";
+import { FieldValue, Timestamp } from "firebase-admin/firestore";
+import { claimWrite, readJsonBody, requireScope } from "@aglyn/tenant-data-admin/server/api-v1-kit";
+import { CRM_TEXT_MAX, CRM_TITLE_MAX, createPayload, crmCollection, crmCreateStamp, crmRefErrors, crmTimes, crmValidationFailed, isoFromMs, listCrm, memberError, parseIsoInstant, readChoice, readCrmSite, readEqualityFilters, readOptionalText, readRefId, refuseUnknownKeys, updatePayload } from "./crm-shared.js";
+const TASK_KINDS = [
+    'call',
+    'email',
+    'meeting',
+    'todo'
+];
+const TASK_PRIORITIES = [
+    'low',
+    'normal',
+    'high'
+];
+const TASK_STATUSES = [
+    'open',
+    'done'
+];
+/** The task object as published. Every writable field appears here. */ function taskView(doc) {
+    var _doc_data, _data_title, _data_notes, _data_kind, _data_priority, _data_status, _data_assigneeUid, _data_contactId, _data_companyId, _data_dealId, _data_hostId;
+    const data = (_doc_data = doc.data()) != null ? _doc_data : {};
+    return _extends({
+        id: doc.id,
+        object: 'task',
+        title: (_data_title = data.title) != null ? _data_title : null,
+        notes: (_data_notes = data.notes) != null ? _data_notes : null,
+        kind: (_data_kind = data.kind) != null ? _data_kind : 'todo',
+        priority: (_data_priority = data.priority) != null ? _data_priority : 'normal',
+        status: (_data_status = data.status) != null ? _data_status : 'open',
+        dueAt: isoFromMs(data.dueAtMs),
+        remindAt: isoFromMs(data.remindAtMs),
+        reminderSentAt: isoFromMs(data.reminderSentAtMs),
+        completedAt: isoFromMs(data.completedAtMs),
+        assigneeUid: (_data_assigneeUid = data.assigneeUid) != null ? _data_assigneeUid : null,
+        contactId: (_data_contactId = data.contactId) != null ? _data_contactId : null,
+        companyId: (_data_companyId = data.companyId) != null ? _data_companyId : null,
+        dealId: (_data_dealId = data.dealId) != null ? _data_dealId : null,
+        siteId: (_data_hostId = data.hostId) != null ? _data_hostId : null
+    }, crmTimes(data));
+}
+const TASK_WRITABLE = new Set([
+    'title',
+    'notes',
+    'kind',
+    'priority',
+    'status',
+    'dueAt',
+    'remindAt',
+    'assigneeUid',
+    'contactId',
+    'companyId',
+    'dealId'
+]);
+function readTaskInput(body, { partial }) {
+    const errors = {};
+    const values = {};
+    const allowed = new Set(TASK_WRITABLE);
+    if (!partial) allowed.add('consentSiteId');
+    refuseUnknownKeys(body, allowed, 'task', errors);
+    if (body.title !== undefined || !partial) {
+        var _body_title;
+        const title = String((_body_title = body.title) != null ? _body_title : '').trim().slice(0, CRM_TITLE_MAX);
+        if (title) values.title = title;
+        else errors.title = partial ? 'Must not be empty' : 'A title is required';
+    }
+    const notes = readOptionalText(body, 'notes', CRM_TEXT_MAX, errors);
+    if (notes !== undefined) values.notes = notes;
+    const kind = readChoice(body, 'kind', TASK_KINDS, errors);
+    if (kind) values.kind = kind;
+    const priority = readChoice(body, 'priority', TASK_PRIORITIES, errors);
+    if (priority) values.priority = priority;
+    const status = readChoice(body, 'status', TASK_STATUSES, errors);
+    if (status) values.status = status;
+    if (body.dueAt !== undefined) {
+        if (body.dueAt === null) {
+            values.dueAtMs = null;
+        } else {
+            const ms = parseIsoInstant(body.dueAt);
+            if (ms === null) {
+                errors.dueAt = 'Must be an ISO 8601 instant, like 2026-09-10T15:00:00Z';
+            } else {
+                values.dueAtMs = ms;
+            }
+        }
+    }
+    if (body.remindAt !== undefined) {
+        if (body.remindAt === null) {
+            values.remindAtMs = null;
+        } else {
+            const ms = parseIsoInstant(body.remindAt);
+            if (ms === null) {
+                errors.remindAt = 'Must be an ISO 8601 instant, like 2026-09-10T14:00:00Z';
+            } else {
+                values.remindAtMs = ms;
+            }
+        }
+    }
+    const assigneeUid = readOptionalText(body, 'assigneeUid', CRM_TITLE_MAX, errors);
+    if (assigneeUid !== undefined) values.assigneeUid = assigneeUid;
+    for (const field of [
+        'contactId',
+        'companyId',
+        'dealId'
+    ]){
+        const id = readRefId(body, field, errors);
+        if (id !== undefined) values[field] = id;
+    }
+    return Object.keys(errors).length ? {
+        errors
+    } : {
+        values
+    };
+}
+async function taskRefErrors(ctx, values) {
+    var _values_contactId, _values_companyId, _values_dealId;
+    const [assignee, refs] = await Promise.all([
+        memberError(ctx, 'assigneeUid', values.assigneeUid),
+        crmRefErrors(ctx, {
+            contactId: (_values_contactId = values.contactId) != null ? _values_contactId : undefined,
+            companyId: (_values_companyId = values.companyId) != null ? _values_companyId : undefined,
+            dealId: (_values_dealId = values.dealId) != null ? _values_dealId : undefined
+        })
+    ]);
+    return _extends({}, assignee, refs);
+}
+/**
+ * The records the task names carry `nextTaskAtMs` (AGL-2661), recomputed
+ * after every write here from BOTH sides of the change. Its own catch: the
+ * task write is done, and a figure that did not move is what the Fields
+ * section's recompute is for, not a failed request.
+ */ async function settleNextActivity(ctx, links) {
+    try {
+        await recomputeCrmNextTaskAt(ctx.firestore, ctx.orgId, links.map((link)=>crmNextActivityLinksOf(link)));
+    } catch (error) {
+        console.error('[api-v1] next activity could not be recomputed', ctx.orgId, error);
+    }
+}
+/** `POST /v1/tasks`. */ async function createTask(request, ctx) {
+    const body = await readJsonBody(request);
+    const parsed = readTaskInput(body, {
+        partial: false
+    });
+    if ('errors' in parsed) return crmValidationFailed(ctx, 'task', parsed.errors);
+    const site = readCrmSite(ctx, 'task', body);
+    if ('response' in site) return site.response;
+    const refErrors = await taskRefErrors(ctx, parsed.values);
+    if (Object.keys(refErrors).length) return crmValidationFailed(ctx, 'task', refErrors);
+    const collection = crmCollection(ctx, CRM_COLLECTIONS.tasks);
+    const claimed = await claimWrite(ctx, '*', request.headers.get('Idempotency-Key'), 'tasks');
+    if ('replay' in claimed) return claimed.replay;
+    const { claim } = claimed;
+    try {
+        var _rest_dueAtMs, _rest_dueAtMs1;
+        const _parsed_values = parsed.values, { title, kind, priority, status, remindAtMs } = _parsed_values, rest = _object_without_properties_loose(_parsed_values, [
+            "title",
+            "kind",
+            "priority",
+            "status",
+            "remindAtMs"
+        ]);
+        const id = createResourceUid();
+        const stamp = crmCreateStamp(ctx, site.siteId);
+        const record = _extends({
+            title,
+            kind: kind != null ? kind : 'todo',
+            priority: priority != null ? priority : 'normal',
+            status: status != null ? status : 'open'
+        }, status === 'done' ? {
+            completedAtMs: stamp.createdAt.toMillis()
+        } : {}, createPayload(_extends({}, rest, {
+            // A reminder on a task created done is owed to nobody.
+            remindAtMs: status === 'done' ? null : crmTaskReminderAfterEdit({
+                dueAtMs: (_rest_dueAtMs = rest.dueAtMs) != null ? _rest_dueAtMs : null,
+                remindAtMs,
+                previous: null
+            })
+        })), {
+            /*
+       * Stored as `null` when the body names none, never left absent: every
+       * tasks list orders by `dueAtMs`, and Firestore leaves a document
+       * without the ordered field out of the answer (AGL-3321).
+       */ dueAtMs: (_rest_dueAtMs1 = rest.dueAtMs) != null ? _rest_dueAtMs1 : null
+        }, stamp);
+        // What the console's Tasks list searches by (AGL-3321).
+        await collection.doc(id).create(_extends({}, record, crmTaskListFields(record)));
+        await settleNextActivity(ctx, [
+            rest
+        ]);
+        const view = taskView(await collection.doc(id).get());
+        await claim.record(200, view);
+        return apiJson(view, {
+            status: 201,
+            headers: ctx.headers
+        });
+    } catch (error) {
+        await claim.release();
+        throw error;
+    }
+}
+/** `PATCH /v1/tasks/{id}`. */ async function updateTask(request, ctx, ref) {
+    const parsed = readTaskInput(await readJsonBody(request), {
+        partial: true
+    });
+    if ('errors' in parsed) return crmValidationFailed(ctx, 'task', parsed.errors);
+    const snap = await ref.get();
+    if (!snap.exists) {
+        return ApiErrors.notFound({
+            message: 'No such task',
+            headers: ctx.headers
+        });
+    }
+    const refErrors = await taskRefErrors(ctx, parsed.values);
+    if (Object.keys(refErrors).length) return crmValidationFailed(ctx, 'task', refErrors);
+    const _parsed_values = parsed.values, { status, remindAtMs } = _parsed_values, rest = _object_without_properties_loose(_parsed_values, [
+        "status",
+        "remindAtMs"
+    ]);
+    const update = updatePayload(rest);
+    // A cleared due date is stored `null`, not deleted — see the create.
+    if (rest.dueAtMs === null) update.dueAtMs = null;
+    // One instant for the write: a task completed at T reads updated at T.
+    const now = Timestamp.now();
+    const completing = status === 'done' && status !== snap.get('status');
+    if (status !== undefined && status !== snap.get('status')) {
+        update.status = status;
+        update.completedAtMs = status === 'done' ? now.toMillis() : null;
+    }
+    /*
+   * The reminder the edit leaves: what the body said, else the rule over
+   * the stored task and the due date this PATCH moves it to. Completion
+   * clears one still owed. A reminder that MOVED — to a time or to none —
+   * is one not yet sent, so the runner's mark comes off with it; one that
+   * stayed keeps its mark.
+   */ const stored = snap.data();
+    const previous = {
+        dueAtMs: typeof stored.dueAtMs === 'number' ? stored.dueAtMs : null,
+        remindAtMs: typeof stored.remindAtMs === 'number' ? stored.remindAtMs : null
+    };
+    const nextRemindAtMs = completing && crmTaskReminderPending(stored) ? null : crmTaskReminderAfterEdit({
+        dueAtMs: rest.dueAtMs === undefined ? previous.dueAtMs : rest.dueAtMs,
+        remindAtMs,
+        previous
+    });
+    if (nextRemindAtMs !== previous.remindAtMs) {
+        update.remindAtMs = nextRemindAtMs === null ? FieldValue.delete() : nextRemindAtMs;
+        update.reminderSentAtMs = FieldValue.delete();
+    }
+    if (Object.keys(update).length > 0) {
+        await ref.update(_extends({}, update, {
+            updatedAt: now
+        }));
+        await settleNextActivity(ctx, [
+            snap.data(),
+            rest
+        ]);
+        // What the console's Tasks list searches (AGL-3321).
+        if ('title' in update) await restampCrmListFieldsAt(ref, 'crmTasks');
+    }
+    return apiJson(taskView(await ref.get()), {
+        headers: ctx.headers
+    });
+}
+/** `DELETE /v1/tasks/{id}`. */ async function deleteTask(request, ctx, ref) {
+    const claimed = await claimWrite(ctx, '*', request.headers.get('Idempotency-Key'), 'task-deletes');
+    if ('replay' in claimed) return claimed.replay;
+    const { claim } = claimed;
+    try {
+        const snap = await ref.get();
+        if (!snap.exists) {
+            await claim.release();
+            return ApiErrors.notFound({
+                message: 'No such task',
+                headers: ctx.headers
+            });
+        }
+        // Read before the delete: the records it named are recomputed without it.
+        const named = snap.data();
+        await ref.delete();
+        await settleNextActivity(ctx, [
+            named
+        ]);
+        const view = {
+            id: ref.id,
+            object: 'task',
+            deleted: true
+        };
+        await claim.record(200, view);
+        return apiJson(view, {
+            headers: ctx.headers
+        });
+    } catch (error) {
+        await claim.release();
+        throw error;
+    }
+}
+/** `GET /v1/tasks` filters, most selective first. */ async function listTasks(ctx, collection, url) {
+    const rawStatus = url.searchParams.get('status');
+    if (rawStatus !== null && rawStatus.trim() !== '' && !TASK_STATUSES.includes(rawStatus.trim())) {
+        return crmValidationFailed(ctx, 'task filter', {
+            status: `Must be one of: ${TASK_STATUSES.join(', ')}`
+        });
+    }
+    const filters = readEqualityFilters(url, [
+        'dealId',
+        'contactId',
+        'companyId',
+        'assigneeUid',
+        'status'
+    ]);
+    return listCrm(ctx, collection, url, filters, taskView);
+}
+export async function handleTasks(request, ctx, segments, url) {
+    const collection = crmCollection(ctx, CRM_COLLECTIONS.tasks);
+    const [, taskId] = segments;
+    if (!taskId) {
+        if (request.method === 'GET') {
+            const denied = requireScope(ctx, 'crm:read');
+            if (denied) return denied;
+            return listTasks(ctx, collection, url);
+        }
+        if (request.method === 'POST') {
+            const denied = requireScope(ctx, 'crm:write');
+            if (denied) return denied;
+            return createTask(request, ctx);
+        }
+        return ApiErrors.methodNotAllowed({
+            headers: _extends({}, ctx.headers, {
+                Allow: 'GET, POST'
+            })
+        });
+    }
+    const ref = collection.doc(taskId);
+    if (request.method === 'GET') {
+        const denied = requireScope(ctx, 'crm:read');
+        if (denied) return denied;
+        const snap = await ref.get();
+        if (!snap.exists) {
+            return ApiErrors.notFound({
+                message: 'No such task',
+                headers: ctx.headers
+            });
+        }
+        return apiJson(taskView(snap), {
+            headers: ctx.headers
+        });
+    }
+    if (request.method === 'PATCH') {
+        const denied = requireScope(ctx, 'crm:write');
+        if (denied) return denied;
+        return updateTask(request, ctx, ref);
+    }
+    if (request.method === 'DELETE') {
+        const denied = requireScope(ctx, 'crm:write');
+        if (denied) return denied;
+        return deleteTask(request, ctx, ref);
+    }
+    return ApiErrors.methodNotAllowed({
+        headers: _extends({}, ctx.headers, {
+            Allow: 'GET, PATCH, DELETE'
+        })
+    });
+}
+
+//# sourceMappingURL=crm-tasks.js.map

package/src/lib/server/api-v1/crm-tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/plugins/crm/src/lib/server/api-v1/crm-tasks.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 * `/v1/tasks` (AGL-2606) — what the team owes a person: a call, an email, a\n * meeting or a to-do, with a due date, pointing at the contact, company or\n * deal it is for. A task may point at nothing — a plain to-do is still a\n * task — which is the one place it differs from an activity.\n *\n * `status` is the only state machine here and it has two states. Marking a\n * task `done` stamps `completedAtMs`; marking it `open` again clears it, so\n * a reopened task never reads as completed on the date it was first closed.\n *\n * `remindAt` (AGL-2659) is the task's reminder: the due time unless the\n * body names a time or `null`, carried along when a moved due date leaves\n * it behind, and cleared by completion while it is still owed — the rule\n * in `crmTaskReminderAfterEdit`, the same one the console's drawer keeps.\n * `reminderSentAt` is read-only: when the hourly runner handled it.\n */\nimport {\n  CRM_COLLECTIONS,\n  type CrmTask,\n  type CrmTaskKind,\n  type CrmTaskPriority,\n  crmTaskReminderAfterEdit,\n  crmTaskReminderPending,\n  type CrmTaskStatus,\n  createResourceUid,\n  crmTaskListFields,\n} from '@aglyn/aglyn/server'\nimport {\n  apiJson,\n  ApiErrors,\n  crmNextActivityLinksOf,\n  recomputeCrmNextTaskAt,\n  restampCrmListFieldsAt,\n} from '@aglyn/tenant-data-admin'\nimport { FieldValue, Timestamp } from 'firebase-admin/firestore'\nimport {\n  type ApiV1Context,\n  claimWrite,\n  readJsonBody,\n  requireScope,\n} from '@aglyn/tenant-data-admin/server/api-v1-kit'\nimport {\n  type Clearable,\n  CRM_TEXT_MAX,\n  CRM_TITLE_MAX,\n  createPayload,\n  crmCollection,\n  crmCreateStamp,\n  crmRefErrors,\n  crmTimes,\n  crmValidationFailed,\n  isoFromMs,\n  listCrm,\n  memberError,\n  parseIsoInstant,\n  readChoice,\n  readCrmSite,\n  readEqualityFilters,\n  readOptionalText,\n  readRefId,\n  refuseUnknownKeys,\n  updatePayload,\n} from './crm-shared'\n\nconst TASK_KINDS = ['call', 'email', 'meeting', 'todo'] as const\nconst TASK_PRIORITIES = ['low', 'normal', 'high'] as const\nconst TASK_STATUSES = ['open', 'done'] as const\n\n/** The task object as published. Every writable field appears here. */\nfunction taskView(doc: FirebaseFirestore.DocumentSnapshot) {\n  const data = (doc.data() ?? {}) as Partial<CrmTask>\n  return {\n    id: doc.id,\n    object: 'task',\n    title: data.title ?? null,\n    notes: data.notes ?? null,\n    kind: data.kind ?? 'todo',\n    priority: data.priority ?? 'normal',\n    status: data.status ?? 'open',\n    dueAt: isoFromMs(data.dueAtMs),\n    remindAt: isoFromMs(data.remindAtMs),\n    reminderSentAt: isoFromMs(data.reminderSentAtMs),\n    completedAt: isoFromMs(data.completedAtMs),\n    assigneeUid: data.assigneeUid ?? null,\n    contactId: data.contactId ?? null,\n    companyId: data.companyId ?? null,\n    dealId: data.dealId ?? null,\n    siteId: data.hostId ?? null,\n    ...crmTimes(data as FirebaseFirestore.DocumentData),\n  }\n}\n\nconst TASK_WRITABLE = new Set([\n  'title',\n  'notes',\n  'kind',\n  'priority',\n  'status',\n  'dueAt',\n  'remindAt',\n  'assigneeUid',\n  'contactId',\n  'companyId',\n  'dealId',\n])\n\ninterface TaskInput {\n  title?: string\n  notes?: Clearable<string>\n  kind?: CrmTaskKind\n  priority?: CrmTaskPriority\n  status?: CrmTaskStatus\n  dueAtMs?: Clearable<number>\n  remindAtMs?: Clearable<number>\n  assigneeUid?: Clearable<string>\n  contactId?: Clearable<string>\n  companyId?: Clearable<string>\n  dealId?: Clearable<string>\n}\n\nfunction readTaskInput(\n  body: Record<string, unknown>,\n  { partial }: { partial: boolean },\n): { values: TaskInput } | { errors: Record<string, string> } {\n  const errors: Record<string, string> = {}\n  const values: TaskInput = {}\n  const allowed = new Set(TASK_WRITABLE)\n  if (!partial) allowed.add('consentSiteId')\n  refuseUnknownKeys(body, allowed, 'task', errors)\n\n  if (body.title !== undefined || !partial) {\n    const title = String(body.title ?? '')\n      .trim()\n      .slice(0, CRM_TITLE_MAX)\n    if (title) values.title = title\n    else errors.title = partial ? 'Must not be empty' : 'A title is required'\n  }\n\n  const notes = readOptionalText(body, 'notes', CRM_TEXT_MAX, errors)\n  if (notes !== undefined) values.notes = notes\n  const kind = readChoice(body, 'kind', TASK_KINDS, errors)\n  if (kind) values.kind = kind\n  const priority = readChoice(body, 'priority', TASK_PRIORITIES, errors)\n  if (priority) values.priority = priority\n  const status = readChoice(body, 'status', TASK_STATUSES, errors)\n  if (status) values.status = status\n\n  if (body.dueAt !== undefined) {\n    if (body.dueAt === null) {\n      values.dueAtMs = null\n    } else {\n      const ms = parseIsoInstant(body.dueAt)\n      if (ms === null) {\n        errors.dueAt = 'Must be an ISO 8601 instant, like 2026-09-10T15:00:00Z'\n      } else {\n        values.dueAtMs = ms\n      }\n    }\n  }\n\n  if (body.remindAt !== undefined) {\n    if (body.remindAt === null) {\n      values.remindAtMs = null\n    } else {\n      const ms = parseIsoInstant(body.remindAt)\n      if (ms === null) {\n        errors.remindAt = 'Must be an ISO 8601 instant, like 2026-09-10T14:00:00Z'\n      } else {\n        values.remindAtMs = ms\n      }\n    }\n  }\n\n  const assigneeUid = readOptionalText(body, 'assigneeUid', CRM_TITLE_MAX, errors)\n  if (assigneeUid !== undefined) values.assigneeUid = assigneeUid\n  for (const field of ['contactId', 'companyId', 'dealId'] as const) {\n    const id = readRefId(body, field, errors)\n    if (id !== undefined) values[field] = id\n  }\n\n  return Object.keys(errors).length ? { errors } : { values }\n}\n\nasync function taskRefErrors(\n  ctx: ApiV1Context,\n  values: TaskInput,\n): Promise<Record<string, string>> {\n  const [assignee, refs] = await Promise.all([\n    memberError(ctx, 'assigneeUid', values.assigneeUid),\n    crmRefErrors(ctx, {\n      contactId: values.contactId ?? undefined,\n      companyId: values.companyId ?? undefined,\n      dealId: values.dealId ?? undefined,\n    }),\n  ])\n  return { ...assignee, ...refs }\n}\n\n/**\n * The records the task names carry `nextTaskAtMs` (AGL-2661), recomputed\n * after every write here from BOTH sides of the change. Its own catch: the\n * task write is done, and a figure that did not move is what the Fields\n * section's recompute is for, not a failed request.\n */\nasync function settleNextActivity(\n  ctx: ApiV1Context,\n  links: readonly (Record<string, unknown> | null | undefined)[],\n): Promise<void> {\n  try {\n    await recomputeCrmNextTaskAt(\n      ctx.firestore,\n      ctx.orgId,\n      links.map((link) => crmNextActivityLinksOf(link)),\n    )\n  } catch (error) {\n    console.error('[api-v1] next activity could not be recomputed', ctx.orgId, error)\n  }\n}\n\n/** `POST /v1/tasks`. */\nasync function createTask(request: Request, ctx: ApiV1Context): Promise<Response> {\n  const body = await readJsonBody(request)\n  const parsed = readTaskInput(body, { partial: false })\n  if ('errors' in parsed) return crmValidationFailed(ctx, 'task', parsed.errors)\n  const site = readCrmSite(ctx, 'task', body)\n  if ('response' in site) return site.response\n  const refErrors = await taskRefErrors(ctx, parsed.values)\n  if (Object.keys(refErrors).length) return crmValidationFailed(ctx, 'task', refErrors)\n\n  const collection = crmCollection(ctx, CRM_COLLECTIONS.tasks)\n  const claimed = await claimWrite(\n    ctx,\n    '*',\n    request.headers.get('Idempotency-Key'),\n    'tasks',\n  )\n  if ('replay' in claimed) return claimed.replay\n  const { claim } = claimed\n\n  try {\n    const { title, kind, priority, status, remindAtMs, ...rest } = parsed.values\n    const id = createResourceUid()\n    const stamp = crmCreateStamp(ctx, site.siteId)\n    const record: Record<string, unknown> = {\n      title,\n      kind: kind ?? 'todo',\n      priority: priority ?? 'normal',\n      status: status ?? 'open',\n      // A task created done was completed the instant it was created — the\n      // same instant its `createdAt` carries.\n      ...(status === 'done' ? { completedAtMs: stamp.createdAt.toMillis() } : {}),\n      ...createPayload({\n        ...rest,\n        // A reminder on a task created done is owed to nobody.\n        remindAtMs:\n          status === 'done'\n            ? null\n            : crmTaskReminderAfterEdit({\n                dueAtMs: rest.dueAtMs ?? null,\n                remindAtMs,\n                previous: null,\n              }),\n      }),\n      /*\n       * Stored as `null` when the body names none, never left absent: every\n       * tasks list orders by `dueAtMs`, and Firestore leaves a document\n       * without the ordered field out of the answer (AGL-3321).\n       */\n      dueAtMs: rest.dueAtMs ?? null,\n      ...stamp,\n    }\n    // What the console's Tasks list searches by (AGL-3321).\n    await collection.doc(id).create({ ...record, ...crmTaskListFields(record) })\n    await settleNextActivity(ctx, [rest as Record<string, unknown>])\n    const view = taskView(await collection.doc(id).get())\n    await claim.record(200, view)\n    return apiJson(view, { status: 201, headers: ctx.headers })\n  } catch (error) {\n    await claim.release()\n    throw error\n  }\n}\n\n/** `PATCH /v1/tasks/{id}`. */\nasync function updateTask(\n  request: Request,\n  ctx: ApiV1Context,\n  ref: FirebaseFirestore.DocumentReference,\n): Promise<Response> {\n  const parsed = readTaskInput(await readJsonBody(request), { partial: true })\n  if ('errors' in parsed) return crmValidationFailed(ctx, 'task', parsed.errors)\n  const snap = await ref.get()\n  if (!snap.exists) {\n    return ApiErrors.notFound({ message: 'No such task', headers: ctx.headers })\n  }\n  const refErrors = await taskRefErrors(ctx, parsed.values)\n  if (Object.keys(refErrors).length) return crmValidationFailed(ctx, 'task', refErrors)\n\n  const { status, remindAtMs, ...rest } = parsed.values\n  const update: Record<string, unknown> = updatePayload(rest)\n  // A cleared due date is stored `null`, not deleted — see the create.\n  if (rest.dueAtMs === null) update.dueAtMs = null\n  // One instant for the write: a task completed at T reads updated at T.\n  const now = Timestamp.now()\n  const completing = status === 'done' && status !== snap.get('status')\n  if (status !== undefined && status !== snap.get('status')) {\n    update.status = status\n    update.completedAtMs = status === 'done' ? now.toMillis() : null\n  }\n  /*\n   * The reminder the edit leaves: what the body said, else the rule over\n   * the stored task and the due date this PATCH moves it to. Completion\n   * clears one still owed. A reminder that MOVED — to a time or to none —\n   * is one not yet sent, so the runner's mark comes off with it; one that\n   * stayed keeps its mark.\n   */\n  const stored = snap.data() as Partial<CrmTask>\n  const previous = {\n    dueAtMs: typeof stored.dueAtMs === 'number' ? stored.dueAtMs : null,\n    remindAtMs: typeof stored.remindAtMs === 'number' ? stored.remindAtMs : null,\n  }\n  const nextRemindAtMs =\n    completing && crmTaskReminderPending(stored)\n      ? null\n      : crmTaskReminderAfterEdit({\n          dueAtMs: rest.dueAtMs === undefined ? previous.dueAtMs : rest.dueAtMs,\n          remindAtMs,\n          previous,\n        })\n  if (nextRemindAtMs !== previous.remindAtMs) {\n    update.remindAtMs = nextRemindAtMs === null ? FieldValue.delete() : nextRemindAtMs\n    update.reminderSentAtMs = FieldValue.delete()\n  }\n  if (Object.keys(update).length > 0) {\n    await ref.update({ ...update, updatedAt: now })\n    await settleNextActivity(ctx, [snap.data(), rest as Record<string, unknown>])\n    // What the console's Tasks list searches (AGL-3321).\n    if ('title' in update) await restampCrmListFieldsAt(ref, 'crmTasks')\n  }\n  return apiJson(taskView(await ref.get()), { headers: ctx.headers })\n}\n\n/** `DELETE /v1/tasks/{id}`. */\nasync function deleteTask(\n  request: Request,\n  ctx: ApiV1Context,\n  ref: FirebaseFirestore.DocumentReference,\n): Promise<Response> {\n  const claimed = await claimWrite(\n    ctx,\n    '*',\n    request.headers.get('Idempotency-Key'),\n    'task-deletes',\n  )\n  if ('replay' in claimed) return claimed.replay\n  const { claim } = claimed\n  try {\n    const snap = await ref.get()\n    if (!snap.exists) {\n      await claim.release()\n      return ApiErrors.notFound({ message: 'No such task', headers: ctx.headers })\n    }\n    // Read before the delete: the records it named are recomputed without it.\n    const named = snap.data()\n    await ref.delete()\n    await settleNextActivity(ctx, [named])\n    const view = { id: ref.id, object: 'task', deleted: true }\n    await claim.record(200, view)\n    return apiJson(view, { headers: ctx.headers })\n  } catch (error) {\n    await claim.release()\n    throw error\n  }\n}\n\n/** `GET /v1/tasks` filters, most selective first. */\nasync function listTasks(\n  ctx: ApiV1Context,\n  collection: FirebaseFirestore.CollectionReference,\n  url: URL,\n): Promise<Response> {\n  const rawStatus = url.searchParams.get('status')\n  if (rawStatus !== null && rawStatus.trim() !== '' && !(TASK_STATUSES as readonly string[]).includes(rawStatus.trim())) {\n    return crmValidationFailed(ctx, 'task filter', {\n      status: `Must be one of: ${TASK_STATUSES.join(', ')}`,\n    })\n  }\n  const filters = readEqualityFilters(url, [\n    'dealId',\n    'contactId',\n    'companyId',\n    'assigneeUid',\n    'status',\n  ])\n  return listCrm(ctx, collection, url, filters, taskView)\n}\n\nexport async function handleTasks(\n  request: Request,\n  ctx: ApiV1Context,\n  segments: string[],\n  url: URL,\n): Promise<Response> {\n  const collection = crmCollection(ctx, CRM_COLLECTIONS.tasks)\n  const [, taskId] = segments\n\n  if (!taskId) {\n    if (request.method === 'GET') {\n      const denied = requireScope(ctx, 'crm:read')\n      if (denied) return denied\n      return listTasks(ctx, collection, url)\n    }\n    if (request.method === 'POST') {\n      const denied = requireScope(ctx, 'crm:write')\n      if (denied) return denied\n      return createTask(request, ctx)\n    }\n    return ApiErrors.methodNotAllowed({\n      headers: { ...ctx.headers, Allow: 'GET, POST' },\n    })\n  }\n\n  const ref = collection.doc(taskId)\n  if (request.method === 'GET') {\n    const denied = requireScope(ctx, 'crm:read')\n    if (denied) return denied\n    const snap = await ref.get()\n    if (!snap.exists) {\n      return ApiErrors.notFound({ message: 'No such task', headers: ctx.headers })\n    }\n    return apiJson(taskView(snap), { headers: ctx.headers })\n  }\n  if (request.method === 'PATCH') {\n    const denied = requireScope(ctx, 'crm:write')\n    if (denied) return denied\n    return updateTask(request, ctx, ref)\n  }\n  if (request.method === 'DELETE') {\n    const denied = requireScope(ctx, 'crm:write')\n    if (denied) return denied\n    return deleteTask(request, ctx, ref)\n  }\n  return ApiErrors.methodNotAllowed({\n    headers: { ...ctx.headers, Allow: 'GET, PATCH, DELETE' },\n  })\n}\n"],"names":["CRM_COLLECTIONS","crmTaskReminderAfterEdit","crmTaskReminderPending","createResourceUid","crmTaskListFields","apiJson","ApiErrors","crmNextActivityLinksOf","recomputeCrmNextTaskAt","restampCrmListFieldsAt","FieldValue","Timestamp","claimWrite","readJsonBody","requireScope","CRM_TEXT_MAX","CRM_TITLE_MAX","createPayload","crmCollection","crmCreateStamp","crmRefErrors","crmTimes","crmValidationFailed","isoFromMs","listCrm","memberError","parseIsoInstant","readChoice","readCrmSite","readEqualityFilters","readOptionalText","readRefId","refuseUnknownKeys","updatePayload","TASK_KINDS","TASK_PRIORITIES","TASK_STATUSES","taskView","doc","data","id","object","title","notes","kind","priority","status","dueAt","dueAtMs","remindAt","remindAtMs","reminderSentAt","reminderSentAtMs","completedAt","completedAtMs","assigneeUid","contactId","companyId","dealId","siteId","hostId","TASK_WRITABLE","Set","readTaskInput","body","partial","errors","values","allowed","add","undefined","String","trim","slice","ms","field","Object","keys","length","taskRefErrors","ctx","assignee","refs","Promise","all","settleNextActivity","links","firestore","orgId","map","link","error","console","createTask","request","parsed","site","response","refErrors","collection","tasks","claimed","headers","get","replay","claim","rest","stamp","record","createdAt","toMillis","previous","create","view","release","updateTask","ref","snap","exists","notFound","message","update","now","completing","stored","nextRemindAtMs","delete","updatedAt","deleteTask","named","deleted","listTasks","url","rawStatus","searchParams","includes","join","filters","handleTasks","segments","taskId","method","denied","methodNotAllowed","Allow"],"mappings":"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"}

package/src/lib/server/api-v1/openapi.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @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 ApiV1ResourceDescription } from '@aglyn/tenant-data-admin/server/api-v1-description';
+/**
+ * The CRM's resources as the customer API's OpenAPI document describes them
+ * (AGL-2733), keyed by the resource each describes — what the console's
+ * builder turns into their paths, tags and schemas, and the MCP tools derive
+ * from.
+ *
+ * Transcribed from the response examples in `apps/docs/api/resources/*.md`,
+ * the customer-facing contract, as the platform's own resources are; each
+ * write body lists its handler's own writable set. `api-v1-openapi.spec.ts`
+ * holds the document to every endpoint the documentation promises.
+ */
+export declare const CRM_API_V1_DESCRIPTIONS: Readonly<Record<string, ApiV1ResourceDescription>>;