@aglyn/plugins-crm 1.0.0-beta.143

package/src/lib/model/task-routes.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/model/task-routes.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 type { CrmTask, CrmTaskKind, CrmTaskPriority } from '@aglyn/aglyn'\n\n/**\n * The contract between the tasks console and the plugin's two task routes\n * (AGL-2599), in one module both halves import so the field a drawer sends\n * and the field a handler reads cannot drift apart.\n *\n * Route PATHS are relative to the console's plugin API prefix: the handler\n * registers `crm/task-save` and the browser calls `/api/crm/task-save`.\n */\nexport const CRM_TASK_ROUTES = {\n  save: 'crm/task-save',\n  complete: 'crm/task-complete',\n} as const\n\n/** The browser-side address of a route: `/api/` + the registered path. */\nexport const crmTaskRouteUrl = (\n  route: (typeof CRM_TASK_ROUTES)[keyof typeof CRM_TASK_ROUTES],\n): string => `/api/${route}`\n\n/**\n * What a person may set on a task. Everything else on the document — scope,\n * provenance, status, timestamps — is the server's to stamp.\n */\nexport interface CrmTaskFields {\n  title: string\n  kind: CrmTaskKind\n  priority: CrmTaskPriority\n  dueAtMs: number | null\n  assigneeUid: string | null\n  notes: string\n  contactId: string | null\n  companyId: string | null\n  dealId: string | null\n  /**\n   * When the assignee is reminded (AGL-2659): a time, `null` for none, or\n   * ABSENT for \"nothing said\" — which the route answers with the rule in\n   * `crmTaskReminderAfterEdit`: a new task's reminder is its due time, and\n   * an edit that moves the due date moves a reminder that still sat on it.\n   * The drawer leaves it absent until the person touches the field.\n   */\n  remindAtMs?: number | null\n}\n\n/**\n * Which level a task route call runs at (AGL-2637), the way\n * `readCrmRouteScope` reads it off the body.\n *\n * `hostId` alone is the SITE variant every route has always had: the org is\n * resolved from the site, the caller's role checked on it, the task stamped\n * with the site's scope. `orgId` is the ORGANIZATION variant, authorized by\n * the org for an org-wide member; a `hostId` beside it names the site a NEW\n * task is filed from, and absent, the task is the organization's own — no\n * site, `hostId: null`, the org scope token alone.\n */\nexport type CrmTaskRouteScope =\n  | { hostId: string; orgId?: undefined }\n  | { orgId: string; hostId?: string | null }\n\n/**\n * The scope a surface calls with, from what it holds: the mounted site, or\n * at the organization level the org the scope hook resolved. `null` until\n * the org is known, which is when a surface has nothing to call with.\n */\nexport function crmTaskCallScope(\n  hostId: string | null | undefined,\n  orgId: string | null | undefined,\n): CrmTaskRouteScope | null {\n  if (hostId) return { hostId }\n  if (orgId) return { orgId }\n  return null\n}\n\nexport type CrmTaskSaveRequest = CrmTaskRouteScope & {\n  /** Absent on create. */\n  taskId?: string\n  task: CrmTaskFields\n}\n\nexport interface CrmTaskSaveResponse {\n  ok: true\n  taskId: string\n  /** Whether the assignee was told — false when they assigned it to themselves. */\n  notified: boolean\n}\n\nexport type CrmTaskCompleteRequest = CrmTaskRouteScope & { taskId: string }\n\nexport interface CrmTaskCompleteResponse {\n  ok: true\n  completedAtMs: number\n  /** The task was already done; nothing was written and no event fired. */\n  alreadyDone?: boolean\n}\n\n/**\n * THE BATCH FORMS, organization level only (AGL-2637).\n *\n * The org hub's bulk bar completes or reassigns a selection in ONE request\n * per action: the same two routes, with `taskIds` (complete) or `tasks`\n * (save) in place of one `taskId`, authorized once by the org. Each task is\n * answered on its own — a refusal names the task and carries the route's\n * sentence — so a selection that reaches a task that has since been deleted\n * still completes the rest. The site hub keeps one request per task, where\n * each is authorized against the site.\n *\n * Capped at the list's own window: a selection cannot be larger than what\n * the list showed.\n */\nexport const CRM_TASK_BATCH_MAX = 200\n\nexport interface CrmTasksCompleteRequest {\n  orgId: string\n  taskIds: string[]\n}\n\nexport type CrmTaskCompleteOutcome =\n  | { taskId: string; ok: true; completedAtMs: number; alreadyDone?: boolean }\n  | { taskId: string; ok: false; error: string }\n\nexport interface CrmTasksCompleteResponse {\n  ok: true\n  results: CrmTaskCompleteOutcome[]\n}\n\nexport interface CrmTasksSaveRequest {\n  orgId: string\n  /** Updates only — a batch never creates. */\n  tasks: Array<{ taskId: string; task: CrmTaskFields }>\n}\n\nexport type CrmTaskSaveOutcome =\n  | { taskId: string; ok: true; notified: boolean }\n  | { taskId: string; ok: false; error: string }\n\nexport interface CrmTasksSaveResponse {\n  ok: true\n  results: CrmTaskSaveOutcome[]\n}\n\nexport const CRM_TASK_TITLE_MAX = 200\nexport const CRM_TASK_NOTES_MAX = 4000\nconst RECORD_ID_MAX = 200\n\nconst KINDS: ReadonlySet<string> = new Set(['call', 'email', 'meeting', 'todo'])\nconst PRIORITIES: ReadonlySet<string> = new Set(['low', 'normal', 'high'])\n\n/**\n * A typed record id, or `null` for anything that is not one.\n *\n * A Firestore id is opaque but bounded, and it never contains a slash — a\n * slash would make it a path. Refusing here rather than storing keeps a\n * malformed link from becoming a `where` clause nothing can match.\n */\nfunction recordId(value: unknown): string | null {\n  const text = String(value ?? '').trim()\n  if (!text || text.length > RECORD_ID_MAX || text.includes('/')) return null\n  return text\n}\n\n/**\n * The request body as a task, or the reason it is not one.\n *\n * Coerces where a person could not have meant anything else (whitespace\n * around a title, a due date sent as a string of digits) and refuses where a\n * guess would store something the list cannot show (an unknown kind, a title\n * that is nothing but spaces). The refusal is a sentence because the drawer\n * puts it in front of the person who typed the value.\n */\nexport function readCrmTaskFields(\n  input: unknown,\n): { ok: true; fields: CrmTaskFields } | { ok: false; error: string } {\n  const raw = (input ?? {}) as Record<string, unknown>\n  const title = String(raw['title'] ?? '').trim()\n  if (!title) return { ok: false, error: 'A task needs a title.' }\n  if (title.length > CRM_TASK_TITLE_MAX) {\n    return {\n      ok: false,\n      error: `A title is at most ${CRM_TASK_TITLE_MAX} characters.`,\n    }\n  }\n  const kind = String(raw['kind'] ?? 'todo')\n  if (!KINDS.has(kind)) {\n    return { ok: false, error: `\"${kind}\" is not a kind of task.` }\n  }\n  const priority = String(raw['priority'] ?? 'normal')\n  if (!PRIORITIES.has(priority)) {\n    return { ok: false, error: `\"${priority}\" is not a priority.` }\n  }\n  const dueRaw = raw['dueAtMs']\n  let dueAtMs: number | null = null\n  if (dueRaw !== null && dueRaw !== undefined && dueRaw !== '') {\n    const ms = Number(dueRaw)\n    if (!Number.isFinite(ms) || ms <= 0) {\n      return { ok: false, error: 'The due date could not be read.' }\n    }\n    dueAtMs = Math.round(ms)\n  }\n  // Three answers, not two: a reminder the body leaves out is the route's\n  // to decide, and only an explicit null or empty string means \"none\".\n  const remindRaw = raw['remindAtMs']\n  let remindAtMs: number | null | undefined\n  if (remindRaw === null || remindRaw === '') {\n    remindAtMs = null\n  } else if (remindRaw !== undefined) {\n    const ms = Number(remindRaw)\n    if (!Number.isFinite(ms) || ms <= 0) {\n      return { ok: false, error: 'The reminder time could not be read.' }\n    }\n    remindAtMs = Math.round(ms)\n  }\n  const assigneeRaw = String(raw['assigneeUid'] ?? '').trim()\n  const notes = String(raw['notes'] ?? '').slice(0, CRM_TASK_NOTES_MAX)\n  const ids = {\n    contactId: raw['contactId'] == null || raw['contactId'] === ''\n      ? null\n      : recordId(raw['contactId']),\n    companyId: raw['companyId'] == null || raw['companyId'] === ''\n      ? null\n      : recordId(raw['companyId']),\n    dealId: raw['dealId'] == null || raw['dealId'] === ''\n      ? null\n      : recordId(raw['dealId']),\n  }\n  for (const [field, value] of Object.entries(ids)) {\n    if (value === null && raw[field] != null && raw[field] !== '') {\n      return { ok: false, error: `The linked ${field.replace('Id', '')} could not be read.` }\n    }\n  }\n  return {\n    ok: true,\n    fields: {\n      title,\n      kind: kind as CrmTaskKind,\n      priority: priority as CrmTaskPriority,\n      dueAtMs,\n      assigneeUid: assigneeRaw || null,\n      notes,\n      ...ids,\n      ...(remindAtMs !== undefined ? { remindAtMs } : {}),\n    },\n  }\n}\n\n/**\n * The stored document's editable half, as the drawer's form reads it.\n *\n * The inverse of what the save route writes, so opening a task and saving it\n * untouched is a no-op on every field the form owns.\n */\nexport function crmTaskFieldsOf(task: Partial<CrmTask>): CrmTaskFields {\n  return {\n    title: task.title ?? '',\n    kind: task.kind ?? 'todo',\n    priority: task.priority ?? 'normal',\n    dueAtMs: typeof task.dueAtMs === 'number' ? task.dueAtMs : null,\n    assigneeUid: task.assigneeUid || null,\n    notes: task.notes ?? '',\n    contactId: task.contactId || null,\n    companyId: task.companyId || null,\n    dealId: task.dealId || null,\n    // A stored task from before reminders existed carries no field, and\n    // reads as having no reminder — the same answer the route's rule gives.\n    remindAtMs: typeof task.remindAtMs === 'number' ? task.remindAtMs : null,\n  }\n}\n"],"names":["CRM_TASK_ROUTES","save","complete","crmTaskRouteUrl","route","crmTaskCallScope","hostId","orgId","CRM_TASK_BATCH_MAX","CRM_TASK_TITLE_MAX","CRM_TASK_NOTES_MAX","RECORD_ID_MAX","KINDS","Set","PRIORITIES","recordId","value","text","String","trim","length","includes","readCrmTaskFields","input","raw","title","ok","error","kind","has","priority","dueRaw","dueAtMs","undefined","ms","Number","isFinite","Math","round","remindRaw","remindAtMs","assigneeRaw","notes","slice","ids","contactId","companyId","dealId","field","Object","entries","replace","fields","assigneeUid","crmTaskFieldsOf","task"],"mappings":"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"}

package/src/lib/model/task-scope.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @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 { CrmTask } from '@aglyn/aglyn/app-utils/crm';
+import { type ScopeToken } from '@aglyn/aglyn/app-utils/scope-tokens';
+/**
+ * The `visibleTo` an ORGANIZATION task carries (AGL-2637): a task filed
+ * from the org hub with no site, `hostId: null`.
+ *
+ * The org token alone — the token every read set leads with, whether the
+ * reader is an org-wide member (the rules admit them to every row) or a
+ * site collaborator (whose projected read set is `['org', 'host:…']`). So
+ * an organization task is listed from the org hub, where a listener
+ * carries no scope clause, AND from every site the organization owns,
+ * exactly as a record the org widened to `defaultResourceScope: 'org'`
+ * is: `crmReadTokens` puts the org token first in every site's read set.
+ * What sets it apart from a widened site task is its `hostId`, not its
+ * scope — see {@link isOrgTask}.
+ *
+ * Frozen and shared rather than built per call because a creator that
+ * spelled it as `[]` would make a task nobody's listener can match.
+ */
+export declare const CRM_ORG_TASK_SCOPE: readonly ScopeToken[];
+/**
+ * Whether a task is the organization's own — created with no site.
+ *
+ * The site is provenance and the one fact that tells an organization task
+ * from a site's task the org has widened: both carry the org token. A
+ * completion of an org task emits no host event, because there is no site
+ * whose automations could hear it.
+ */
+export declare function isOrgTask(task: Pick<Partial<CrmTask>, 'hostId'>): boolean;

package/src/lib/model/task-scope.js

@@ -0,0 +1,51 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ /*
+ * Named beneath the entry barrel, not `@aglyn/aglyn`: the save and complete
+ * routes import this module, and the barrel reaches the console's React
+ * contexts, which the App Router's server graph refuses (AGL-405).
+ */ import { ORG_SCOPE_TOKEN } from "@aglyn/aglyn/app-utils/scope-tokens";
+/**
+ * The `visibleTo` an ORGANIZATION task carries (AGL-2637): a task filed
+ * from the org hub with no site, `hostId: null`.
+ *
+ * The org token alone — the token every read set leads with, whether the
+ * reader is an org-wide member (the rules admit them to every row) or a
+ * site collaborator (whose projected read set is `['org', 'host:…']`). So
+ * an organization task is listed from the org hub, where a listener
+ * carries no scope clause, AND from every site the organization owns,
+ * exactly as a record the org widened to `defaultResourceScope: 'org'`
+ * is: `crmReadTokens` puts the org token first in every site's read set.
+ * What sets it apart from a widened site task is its `hostId`, not its
+ * scope — see {@link isOrgTask}.
+ *
+ * Frozen and shared rather than built per call because a creator that
+ * spelled it as `[]` would make a task nobody's listener can match.
+ */ export const CRM_ORG_TASK_SCOPE = Object.freeze([
+    ORG_SCOPE_TOKEN
+]);
+/**
+ * Whether a task is the organization's own — created with no site.
+ *
+ * The site is provenance and the one fact that tells an organization task
+ * from a site's task the org has widened: both carry the org token. A
+ * completion of an org task emits no host event, because there is no site
+ * whose automations could hear it.
+ */ export function isOrgTask(task) {
+    return !task.hostId;
+}
+
+//# sourceMappingURL=task-scope.js.map

package/src/lib/model/task-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/model/task-scope.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 * Named beneath the entry barrel, not `@aglyn/aglyn`: the save and complete\n * routes import this module, and the barrel reaches the console's React\n * contexts, which the App Router's server graph refuses (AGL-405).\n */\nimport type { CrmTask } from '@aglyn/aglyn/app-utils/crm'\nimport {\n  ORG_SCOPE_TOKEN,\n  type ScopeToken,\n} from '@aglyn/aglyn/app-utils/scope-tokens'\n\n/**\n * The `visibleTo` an ORGANIZATION task carries (AGL-2637): a task filed\n * from the org hub with no site, `hostId: null`.\n *\n * The org token alone — the token every read set leads with, whether the\n * reader is an org-wide member (the rules admit them to every row) or a\n * site collaborator (whose projected read set is `['org', 'host:…']`). So\n * an organization task is listed from the org hub, where a listener\n * carries no scope clause, AND from every site the organization owns,\n * exactly as a record the org widened to `defaultResourceScope: 'org'`\n * is: `crmReadTokens` puts the org token first in every site's read set.\n * What sets it apart from a widened site task is its `hostId`, not its\n * scope — see {@link isOrgTask}.\n *\n * Frozen and shared rather than built per call because a creator that\n * spelled it as `[]` would make a task nobody's listener can match.\n */\nexport const CRM_ORG_TASK_SCOPE: readonly ScopeToken[] = Object.freeze([\n  ORG_SCOPE_TOKEN,\n])\n\n/**\n * Whether a task is the organization's own — created with no site.\n *\n * The site is provenance and the one fact that tells an organization task\n * from a site's task the org has widened: both carry the org token. A\n * completion of an org task emits no host event, because there is no site\n * whose automations could hear it.\n */\nexport function isOrgTask(task: Pick<Partial<CrmTask>, 'hostId'>): boolean {\n  return !task.hostId\n}\n"],"names":["ORG_SCOPE_TOKEN","CRM_ORG_TASK_SCOPE","Object","freeze","isOrgTask","task","hostId"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;CAIC,GAED,SACEA,eAAe,QAEV,sCAAqC;AAE5C;;;;;;;;;;;;;;;;CAgBC,GACD,OAAO,MAAMC,qBAA4CC,OAAOC,MAAM,CAAC;IACrEH;CACD,EAAC;AAEF;;;;;;;CAOC,GACD,OAAO,SAASI,UAAUC,IAAsC;IAC9D,OAAO,CAACA,KAAKC,MAAM;AACrB"}

package/src/lib/model/task-views.d.ts

@@ -0,0 +1,149 @@
+/**
+ * @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 CrmTask, type CrmTaskKind, type CrmTaskPriority, type TaskDueState } from '@aglyn/aglyn';
+import type { CrmRoutes } from './crm-routes';
+/**
+ * The tasks section's views and the query each one is (AGL-2599).
+ *
+ * Pure: what a view MEANS is written here once, as a plan the hook turns into
+ * Firestore constraints and a spec can read back without Firestore. "Overdue"
+ * and "today" are not stored on the task — nothing runs at midnight to stamp
+ * them — so each view is a window over `dueAtMs` computed at read time from
+ * the reader's own clock, and the same day boundaries {@link taskDueState}
+ * paints a row with.
+ */
+export type CrmTaskView = 'mine' | 'overdue' | 'today' | 'upcoming' | 'open' | 'done';
+export declare const CRM_TASK_VIEWS: ReadonlyArray<{
+    id: CrmTaskView;
+    label: string;
+}>;
+export declare const CRM_TASK_KINDS: readonly CrmTaskKind[];
+export declare const CRM_TASK_KIND_LABELS: Record<CrmTaskKind, string>;
+export declare const CRM_TASK_PRIORITIES: readonly CrmTaskPriority[];
+export declare const CRM_TASK_PRIORITY_LABELS: Record<CrmTaskPriority, string>;
+/**
+ * How many rows a view reads at most.
+ *
+ * Every view is a listener, and a listener with no cap is a bill that grows
+ * with the org. Two hundred is more than a person works through in a sitting
+ * and far under what a table paints comfortably; the list says when the
+ * window is full so a reader knows to narrow the view rather than assume
+ * the end of the table is the end of the work.
+ */
+export declare const CRM_TASK_VIEW_LIMIT = 200;
+/** Midnight at the START of the local calendar day `nowMs` falls in. */
+export declare function startOfLocalDay(nowMs: number): number;
+/**
+ * Midnight at the start of the NEXT local day — built from the calendar
+ * rather than by adding 24 hours, because a day that a clock change falls in
+ * is 23 or 25 hours long and a task due at 00:30 on that morning belongs to
+ * it either way.
+ */
+export declare function startOfNextLocalDay(nowMs: number): number;
+/**
+ * One view as constraints, in the vocabulary of the `crmTasks` indexes.
+ *
+ * `assigneeUid` narrows to the reader and rides the
+ * `(visibleTo, assigneeUid, status, dueAtMs)` index; every other view rides
+ * `(visibleTo, status, dueAtMs)`. `dueFrom` is inclusive and `dueBefore`
+ * exclusive so that two adjacent windows share a boundary and no task falls
+ * between "today" and "upcoming". A task with no due date has `dueAtMs:
+ * null`, which a range excludes and a bare order sorts first, so it appears
+ * in "My tasks" and "All open" and in none of the dated views.
+ */
+export interface CrmTaskViewPlan {
+    status: 'open' | 'done';
+    assigneeUid?: string;
+    dueFrom?: number;
+    dueBefore?: number;
+    direction: 'asc' | 'desc';
+}
+export declare function crmTaskViewPlan(view: CrmTaskView, options: {
+    nowMs: number;
+    uid: string | null | undefined;
+}): CrmTaskViewPlan;
+/**
+ * Rows in the order a view should paint them.
+ *
+ * Firestore sorts `null` before every number, so an ascending order by
+ * `dueAtMs` puts the undated tasks at the TOP of "All open" — above the one
+ * due in an hour. The query stays as it is (the index decides that); the
+ * undated rows are moved to the end here, in a stable pass that leaves the
+ * dated order the server chose alone.
+ */
+export declare function orderTaskRows<T extends Pick<CrmTask, 'dueAtMs'>>(rows: readonly T[]): T[];
+/** The MUI palette key a due date is painted with, by its state. */
+export declare const TASK_DUE_COLORS: Record<TaskDueState, string>;
+/**
+ * The due date as a person reads it: "Overdue · Tue, Sep 1, 9:00 AM",
+ * "Today, 3:30 PM", "No due date". The state word comes first because it is
+ * the part a reader scans a column for; the timestamp is what they read once
+ * a row has their attention.
+ */
+export declare function describeTaskDue(task: Pick<CrmTask, 'status' | 'dueAtMs'>, nowMs: number, locale?: string): {
+    state: TaskDueState;
+    label: string;
+};
+/**
+ * `datetime-local` ↔ epoch milliseconds, in the reader's own zone.
+ *
+ * The input's value is a wall-clock string with no zone; `new Date(string)`
+ * reads such a string as LOCAL time, which is what a person typing "9:00"
+ * into a due-date field means. Built by hand in the other direction because
+ * `toISOString()` would render the UTC clock, and a task due at nine would
+ * reopen in the drawer at whatever nine is in Greenwich.
+ */
+export declare function dueAtToLocalInput(ms: number | null | undefined): string;
+export declare function localInputToDueAt(value: string): number | null;
+/**
+ * The two snoozes a row and the drawer offer by name (AGL-2619), in the
+ * order a person reaches for them; "Pick a date" is the third and takes a
+ * date rather than an option.
+ */
+export type CrmTaskSnoozeOption = 'tomorrow' | 'nextWeek';
+export declare const CRM_TASK_SNOOZE_OPTIONS: ReadonlyArray<{
+    id: CrmTaskSnoozeOption;
+    label: string;
+}>;
+/** The hour a snoozed task lands on when it had no time of day of its own. */
+export declare const CRM_TASK_SNOOZE_DEFAULT_HOUR = 9;
+/**
+ * Where a snoozed task is due next.
+ *
+ * Counted from NOW, not from the old due date: a task a week overdue
+ * snoozed to "tomorrow" is due tomorrow, which is what the word means to the
+ * person pressing it, and not due six days ago. The time of day is kept —
+ * a nine o'clock call stays a nine o'clock call — and a task that had no
+ * time lands at {@link CRM_TASK_SNOOZE_DEFAULT_HOUR}, a working hour rather
+ * than midnight. Built from the calendar for the reason
+ * {@link startOfNextLocalDay} gives.
+ */
+export declare function snoozeDueAt(option: CrmTaskSnoozeOption, dueAtMs: number | null | undefined, nowMs: number): number;
+/**
+ * The record a task hangs off, as a link into the hub — or `null` for a
+ * task that is nobody's in particular.
+ *
+ * One record per task on screen even when the document names more than one:
+ * the contact wins, then the deal, then the company, because that is the
+ * order of how specific each is about WHO the work is for. All three ids
+ * stay on the document for the record pages' own queries.
+ */
+export declare function taskRecordLink(task: Pick<CrmTask, 'contactId' | 'companyId' | 'dealId'>, routes: CrmRoutes): {
+    kind: 'contact' | 'deal' | 'company';
+    id: string;
+    href: string;
+} | null;

package/src/lib/model/task-views.js

@@ -0,0 +1,286 @@
+/**
+ * @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 { taskDueState } from "@aglyn/aglyn";
+export const CRM_TASK_VIEWS = [
+    {
+        id: 'mine',
+        label: 'My tasks'
+    },
+    {
+        id: 'overdue',
+        label: 'Overdue'
+    },
+    {
+        id: 'today',
+        label: 'Today'
+    },
+    {
+        id: 'upcoming',
+        label: 'Upcoming'
+    },
+    {
+        id: 'open',
+        label: 'All open'
+    },
+    {
+        id: 'done',
+        label: 'Done'
+    }
+];
+export const CRM_TASK_KINDS = [
+    'call',
+    'email',
+    'meeting',
+    'todo'
+];
+export const CRM_TASK_KIND_LABELS = {
+    call: 'Call',
+    email: 'Email',
+    meeting: 'Meeting',
+    todo: 'To-do'
+};
+export const CRM_TASK_PRIORITIES = [
+    'low',
+    'normal',
+    'high'
+];
+export const CRM_TASK_PRIORITY_LABELS = {
+    low: 'Low',
+    normal: 'Normal',
+    high: 'High'
+};
+/**
+ * How many rows a view reads at most.
+ *
+ * Every view is a listener, and a listener with no cap is a bill that grows
+ * with the org. Two hundred is more than a person works through in a sitting
+ * and far under what a table paints comfortably; the list says when the
+ * window is full so a reader knows to narrow the view rather than assume
+ * the end of the table is the end of the work.
+ */ export const CRM_TASK_VIEW_LIMIT = 200;
+/** Midnight at the START of the local calendar day `nowMs` falls in. */ export function startOfLocalDay(nowMs) {
+    const date = new Date(nowMs);
+    return new Date(date.getFullYear(), date.getMonth(), date.getDate()).getTime();
+}
+/**
+ * Midnight at the start of the NEXT local day — built from the calendar
+ * rather than by adding 24 hours, because a day that a clock change falls in
+ * is 23 or 25 hours long and a task due at 00:30 on that morning belongs to
+ * it either way.
+ */ export function startOfNextLocalDay(nowMs) {
+    const date = new Date(nowMs);
+    return new Date(date.getFullYear(), date.getMonth(), date.getDate() + 1).getTime();
+}
+export function crmTaskViewPlan(view, options) {
+    const { nowMs, uid } = options;
+    const today = startOfLocalDay(nowMs);
+    const tomorrow = startOfNextLocalDay(nowMs);
+    switch(view){
+        case 'mine':
+            return {
+                status: 'open',
+                assigneeUid: uid != null ? uid : '',
+                direction: 'asc'
+            };
+        case 'overdue':
+            return {
+                status: 'open',
+                dueBefore: today,
+                direction: 'asc'
+            };
+        case 'today':
+            return {
+                status: 'open',
+                dueFrom: today,
+                dueBefore: tomorrow,
+                direction: 'asc'
+            };
+        case 'upcoming':
+            return {
+                status: 'open',
+                dueFrom: tomorrow,
+                direction: 'asc'
+            };
+        case 'open':
+            return {
+                status: 'open',
+                direction: 'asc'
+            };
+        case 'done':
+            // Most recently due first: what was finished lately is what a reader
+            // scrolls the Done view for, and the oldest completed task is the one
+            // nobody comes back to.
+            return {
+                status: 'done',
+                direction: 'desc'
+            };
+    }
+}
+/**
+ * Rows in the order a view should paint them.
+ *
+ * Firestore sorts `null` before every number, so an ascending order by
+ * `dueAtMs` puts the undated tasks at the TOP of "All open" — above the one
+ * due in an hour. The query stays as it is (the index decides that); the
+ * undated rows are moved to the end here, in a stable pass that leaves the
+ * dated order the server chose alone.
+ */ export function orderTaskRows(rows) {
+    const dated = [];
+    const undated = [];
+    for (const row of rows){
+        ;
+        (typeof row.dueAtMs === 'number' ? dated : undated).push(row);
+    }
+    return [
+        ...dated,
+        ...undated
+    ];
+}
+/** The MUI palette key a due date is painted with, by its state. */ export const TASK_DUE_COLORS = {
+    overdue: 'error.main',
+    today: 'warning.main',
+    upcoming: 'text.primary',
+    none: 'text.secondary',
+    done: 'text.secondary'
+};
+/**
+ * The due date as a person reads it: "Overdue · Tue, Sep 1, 9:00 AM",
+ * "Today, 3:30 PM", "No due date". The state word comes first because it is
+ * the part a reader scans a column for; the timestamp is what they read once
+ * a row has their attention.
+ */ export function describeTaskDue(task, nowMs, locale) {
+    const state = taskDueState(task, nowMs);
+    const dueAtMs = task.dueAtMs;
+    if (typeof dueAtMs !== 'number' || !Number.isFinite(dueAtMs)) {
+        return {
+            state,
+            label: 'No due date'
+        };
+    }
+    const due = new Date(dueAtMs);
+    const time = due.toLocaleTimeString(locale, {
+        hour: 'numeric',
+        minute: '2-digit'
+    });
+    switch(state){
+        case 'today':
+            return {
+                state,
+                label: `Today, ${time}`
+            };
+        case 'overdue':
+            return {
+                state,
+                label: `Overdue · ${due.toLocaleDateString(locale, {
+                    weekday: 'short',
+                    month: 'short',
+                    day: 'numeric'
+                })}, ${time}`
+            };
+        default:
+            return {
+                state,
+                label: `${due.toLocaleDateString(locale, {
+                    weekday: 'short',
+                    month: 'short',
+                    day: 'numeric'
+                })}, ${time}`
+            };
+    }
+}
+/**
+ * `datetime-local` ↔ epoch milliseconds, in the reader's own zone.
+ *
+ * The input's value is a wall-clock string with no zone; `new Date(string)`
+ * reads such a string as LOCAL time, which is what a person typing "9:00"
+ * into a due-date field means. Built by hand in the other direction because
+ * `toISOString()` would render the UTC clock, and a task due at nine would
+ * reopen in the drawer at whatever nine is in Greenwich.
+ */ export function dueAtToLocalInput(ms) {
+    if (typeof ms !== 'number' || !Number.isFinite(ms)) return '';
+    const date = new Date(ms);
+    const pad = (value)=>String(value).padStart(2, '0');
+    return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-` + `${pad(date.getDate())}T${pad(date.getHours())}:${pad(date.getMinutes())}`;
+}
+export function localInputToDueAt(value) {
+    const text = String(value != null ? value : '').trim();
+    if (!text) return null;
+    const ms = new Date(text).getTime();
+    return Number.isFinite(ms) ? ms : null;
+}
+export const CRM_TASK_SNOOZE_OPTIONS = [
+    {
+        id: 'tomorrow',
+        label: 'Tomorrow'
+    },
+    {
+        id: 'nextWeek',
+        label: 'Next week'
+    }
+];
+/** The hour a snoozed task lands on when it had no time of day of its own. */ export const CRM_TASK_SNOOZE_DEFAULT_HOUR = 9;
+/**
+ * Where a snoozed task is due next.
+ *
+ * Counted from NOW, not from the old due date: a task a week overdue
+ * snoozed to "tomorrow" is due tomorrow, which is what the word means to the
+ * person pressing it, and not due six days ago. The time of day is kept —
+ * a nine o'clock call stays a nine o'clock call — and a task that had no
+ * time lands at {@link CRM_TASK_SNOOZE_DEFAULT_HOUR}, a working hour rather
+ * than midnight. Built from the calendar for the reason
+ * {@link startOfNextLocalDay} gives.
+ */ export function snoozeDueAt(option, dueAtMs, nowMs) {
+    const had = typeof dueAtMs === 'number' && Number.isFinite(dueAtMs) ? new Date(dueAtMs) : null;
+    const hours = had ? had.getHours() : CRM_TASK_SNOOZE_DEFAULT_HOUR;
+    const minutes = had ? had.getMinutes() : 0;
+    const now = new Date(nowMs);
+    const days = option === 'tomorrow' ? 1 : 7;
+    return new Date(now.getFullYear(), now.getMonth(), now.getDate() + days, hours, minutes).getTime();
+}
+/**
+ * The record a task hangs off, as a link into the hub — or `null` for a
+ * task that is nobody's in particular.
+ *
+ * One record per task on screen even when the document names more than one:
+ * the contact wins, then the deal, then the company, because that is the
+ * order of how specific each is about WHO the work is for. All three ids
+ * stay on the document for the record pages' own queries.
+ */ export function taskRecordLink(task, routes) {
+    if (task.contactId) {
+        return {
+            kind: 'contact',
+            id: task.contactId,
+            href: routes.contact(task.contactId)
+        };
+    }
+    if (task.dealId) {
+        return {
+            kind: 'deal',
+            id: task.dealId,
+            href: routes.deal(task.dealId)
+        };
+    }
+    if (task.companyId) {
+        return {
+            kind: 'company',
+            id: task.companyId,
+            href: routes.company(task.companyId)
+        };
+    }
+    return null;
+}
+
+//# sourceMappingURL=task-views.js.map

package/src/lib/model/task-views.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/model/task-views.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  type CrmTask,\n  type CrmTaskKind,\n  type CrmTaskPriority,\n  type TaskDueState,\n  taskDueState,\n} from '@aglyn/aglyn'\nimport type { CrmRoutes } from './crm-routes'\n\n/**\n * The tasks section's views and the query each one is (AGL-2599).\n *\n * Pure: what a view MEANS is written here once, as a plan the hook turns into\n * Firestore constraints and a spec can read back without Firestore. \"Overdue\"\n * and \"today\" are not stored on the task — nothing runs at midnight to stamp\n * them — so each view is a window over `dueAtMs` computed at read time from\n * the reader's own clock, and the same day boundaries {@link taskDueState}\n * paints a row with.\n */\n\nexport type CrmTaskView =\n  | 'mine'\n  | 'overdue'\n  | 'today'\n  | 'upcoming'\n  | 'open'\n  | 'done'\n\nexport const CRM_TASK_VIEWS: ReadonlyArray<{ id: CrmTaskView; label: string }> =\n  [\n    { id: 'mine', label: 'My tasks' },\n    { id: 'overdue', label: 'Overdue' },\n    { id: 'today', label: 'Today' },\n    { id: 'upcoming', label: 'Upcoming' },\n    { id: 'open', label: 'All open' },\n    { id: 'done', label: 'Done' },\n  ]\n\nexport const CRM_TASK_KINDS: readonly CrmTaskKind[] = [\n  'call',\n  'email',\n  'meeting',\n  'todo',\n]\n\nexport const CRM_TASK_KIND_LABELS: Record<CrmTaskKind, string> = {\n  call: 'Call',\n  email: 'Email',\n  meeting: 'Meeting',\n  todo: 'To-do',\n}\n\nexport const CRM_TASK_PRIORITIES: readonly CrmTaskPriority[] = [\n  'low',\n  'normal',\n  'high',\n]\n\nexport const CRM_TASK_PRIORITY_LABELS: Record<CrmTaskPriority, string> = {\n  low: 'Low',\n  normal: 'Normal',\n  high: 'High',\n}\n\n/**\n * How many rows a view reads at most.\n *\n * Every view is a listener, and a listener with no cap is a bill that grows\n * with the org. Two hundred is more than a person works through in a sitting\n * and far under what a table paints comfortably; the list says when the\n * window is full so a reader knows to narrow the view rather than assume\n * the end of the table is the end of the work.\n */\nexport const CRM_TASK_VIEW_LIMIT = 200\n\n/** Midnight at the START of the local calendar day `nowMs` falls in. */\nexport function startOfLocalDay(nowMs: number): number {\n  const date = new Date(nowMs)\n  return new Date(date.getFullYear(), date.getMonth(), date.getDate()).getTime()\n}\n\n/**\n * Midnight at the start of the NEXT local day — built from the calendar\n * rather than by adding 24 hours, because a day that a clock change falls in\n * is 23 or 25 hours long and a task due at 00:30 on that morning belongs to\n * it either way.\n */\nexport function startOfNextLocalDay(nowMs: number): number {\n  const date = new Date(nowMs)\n  return new Date(\n    date.getFullYear(),\n    date.getMonth(),\n    date.getDate() + 1,\n  ).getTime()\n}\n\n/**\n * One view as constraints, in the vocabulary of the `crmTasks` indexes.\n *\n * `assigneeUid` narrows to the reader and rides the\n * `(visibleTo, assigneeUid, status, dueAtMs)` index; every other view rides\n * `(visibleTo, status, dueAtMs)`. `dueFrom` is inclusive and `dueBefore`\n * exclusive so that two adjacent windows share a boundary and no task falls\n * between \"today\" and \"upcoming\". A task with no due date has `dueAtMs:\n * null`, which a range excludes and a bare order sorts first, so it appears\n * in \"My tasks\" and \"All open\" and in none of the dated views.\n */\nexport interface CrmTaskViewPlan {\n  status: 'open' | 'done'\n  assigneeUid?: string\n  dueFrom?: number\n  dueBefore?: number\n  direction: 'asc' | 'desc'\n}\n\nexport function crmTaskViewPlan(\n  view: CrmTaskView,\n  options: { nowMs: number; uid: string | null | undefined },\n): CrmTaskViewPlan {\n  const { nowMs, uid } = options\n  const today = startOfLocalDay(nowMs)\n  const tomorrow = startOfNextLocalDay(nowMs)\n  switch (view) {\n    case 'mine':\n      return { status: 'open', assigneeUid: uid ?? '', direction: 'asc' }\n    case 'overdue':\n      return { status: 'open', dueBefore: today, direction: 'asc' }\n    case 'today':\n      return { status: 'open', dueFrom: today, dueBefore: tomorrow, direction: 'asc' }\n    case 'upcoming':\n      return { status: 'open', dueFrom: tomorrow, direction: 'asc' }\n    case 'open':\n      return { status: 'open', direction: 'asc' }\n    case 'done':\n      // Most recently due first: what was finished lately is what a reader\n      // scrolls the Done view for, and the oldest completed task is the one\n      // nobody comes back to.\n      return { status: 'done', direction: 'desc' }\n  }\n}\n\n/**\n * Rows in the order a view should paint them.\n *\n * Firestore sorts `null` before every number, so an ascending order by\n * `dueAtMs` puts the undated tasks at the TOP of \"All open\" — above the one\n * due in an hour. The query stays as it is (the index decides that); the\n * undated rows are moved to the end here, in a stable pass that leaves the\n * dated order the server chose alone.\n */\nexport function orderTaskRows<T extends Pick<CrmTask, 'dueAtMs'>>(\n  rows: readonly T[],\n): T[] {\n  const dated: T[] = []\n  const undated: T[] = []\n  for (const row of rows) {\n    ;(typeof row.dueAtMs === 'number' ? dated : undated).push(row)\n  }\n  return [...dated, ...undated]\n}\n\n/** The MUI palette key a due date is painted with, by its state. */\nexport const TASK_DUE_COLORS: Record<TaskDueState, string> = {\n  overdue: 'error.main',\n  today: 'warning.main',\n  upcoming: 'text.primary',\n  none: 'text.secondary',\n  done: 'text.secondary',\n}\n\n/**\n * The due date as a person reads it: \"Overdue · Tue, Sep 1, 9:00 AM\",\n * \"Today, 3:30 PM\", \"No due date\". The state word comes first because it is\n * the part a reader scans a column for; the timestamp is what they read once\n * a row has their attention.\n */\nexport function describeTaskDue(\n  task: Pick<CrmTask, 'status' | 'dueAtMs'>,\n  nowMs: number,\n  locale?: string,\n): { state: TaskDueState; label: string } {\n  const state = taskDueState(task, nowMs)\n  const dueAtMs = task.dueAtMs\n  if (typeof dueAtMs !== 'number' || !Number.isFinite(dueAtMs)) {\n    return { state, label: 'No due date' }\n  }\n  const due = new Date(dueAtMs)\n  const time = due.toLocaleTimeString(locale, {\n    hour: 'numeric',\n    minute: '2-digit',\n  })\n  switch (state) {\n    case 'today':\n      return { state, label: `Today, ${time}` }\n    case 'overdue':\n      return {\n        state,\n        label: `Overdue · ${due.toLocaleDateString(locale, {\n          weekday: 'short',\n          month: 'short',\n          day: 'numeric',\n        })}, ${time}`,\n      }\n    default:\n      return {\n        state,\n        label: `${due.toLocaleDateString(locale, {\n          weekday: 'short',\n          month: 'short',\n          day: 'numeric',\n        })}, ${time}`,\n      }\n  }\n}\n\n/**\n * `datetime-local` ↔ epoch milliseconds, in the reader's own zone.\n *\n * The input's value is a wall-clock string with no zone; `new Date(string)`\n * reads such a string as LOCAL time, which is what a person typing \"9:00\"\n * into a due-date field means. Built by hand in the other direction because\n * `toISOString()` would render the UTC clock, and a task due at nine would\n * reopen in the drawer at whatever nine is in Greenwich.\n */\nexport function dueAtToLocalInput(ms: number | null | undefined): string {\n  if (typeof ms !== 'number' || !Number.isFinite(ms)) return ''\n  const date = new Date(ms)\n  const pad = (value: number) => String(value).padStart(2, '0')\n  return (\n    `${date.getFullYear()}-${pad(date.getMonth() + 1)}-` +\n    `${pad(date.getDate())}T${pad(date.getHours())}:${pad(date.getMinutes())}`\n  )\n}\n\nexport function localInputToDueAt(value: string): number | null {\n  const text = String(value ?? '').trim()\n  if (!text) return null\n  const ms = new Date(text).getTime()\n  return Number.isFinite(ms) ? ms : null\n}\n\n/**\n * The two snoozes a row and the drawer offer by name (AGL-2619), in the\n * order a person reaches for them; \"Pick a date\" is the third and takes a\n * date rather than an option.\n */\nexport type CrmTaskSnoozeOption = 'tomorrow' | 'nextWeek'\n\nexport const CRM_TASK_SNOOZE_OPTIONS: ReadonlyArray<{\n  id: CrmTaskSnoozeOption\n  label: string\n}> = [\n  { id: 'tomorrow', label: 'Tomorrow' },\n  { id: 'nextWeek', label: 'Next week' },\n]\n\n/** The hour a snoozed task lands on when it had no time of day of its own. */\nexport const CRM_TASK_SNOOZE_DEFAULT_HOUR = 9\n\n/**\n * Where a snoozed task is due next.\n *\n * Counted from NOW, not from the old due date: a task a week overdue\n * snoozed to \"tomorrow\" is due tomorrow, which is what the word means to the\n * person pressing it, and not due six days ago. The time of day is kept —\n * a nine o'clock call stays a nine o'clock call — and a task that had no\n * time lands at {@link CRM_TASK_SNOOZE_DEFAULT_HOUR}, a working hour rather\n * than midnight. Built from the calendar for the reason\n * {@link startOfNextLocalDay} gives.\n */\nexport function snoozeDueAt(\n  option: CrmTaskSnoozeOption,\n  dueAtMs: number | null | undefined,\n  nowMs: number,\n): number {\n  const had = typeof dueAtMs === 'number' && Number.isFinite(dueAtMs) ? new Date(dueAtMs) : null\n  const hours = had ? had.getHours() : CRM_TASK_SNOOZE_DEFAULT_HOUR\n  const minutes = had ? had.getMinutes() : 0\n  const now = new Date(nowMs)\n  const days = option === 'tomorrow' ? 1 : 7\n  return new Date(\n    now.getFullYear(),\n    now.getMonth(),\n    now.getDate() + days,\n    hours,\n    minutes,\n  ).getTime()\n}\n\n/**\n * The record a task hangs off, as a link into the hub — or `null` for a\n * task that is nobody's in particular.\n *\n * One record per task on screen even when the document names more than one:\n * the contact wins, then the deal, then the company, because that is the\n * order of how specific each is about WHO the work is for. All three ids\n * stay on the document for the record pages' own queries.\n */\nexport function taskRecordLink(\n  task: Pick<CrmTask, 'contactId' | 'companyId' | 'dealId'>,\n  routes: CrmRoutes,\n): { kind: 'contact' | 'deal' | 'company'; id: string; href: string } | null {\n  if (task.contactId) {\n    return { kind: 'contact', id: task.contactId, href: routes.contact(task.contactId) }\n  }\n  if (task.dealId) {\n    return { kind: 'deal', id: task.dealId, href: routes.deal(task.dealId) }\n  }\n  if (task.companyId) {\n    return { kind: 'company', id: task.companyId, href: routes.company(task.companyId) }\n  }\n  return null\n}\n"],"names":["taskDueState","CRM_TASK_VIEWS","id","label","CRM_TASK_KINDS","CRM_TASK_KIND_LABELS","call","email","meeting","todo","CRM_TASK_PRIORITIES","CRM_TASK_PRIORITY_LABELS","low","normal","high","CRM_TASK_VIEW_LIMIT","startOfLocalDay","nowMs","date","Date","getFullYear","getMonth","getDate","getTime","startOfNextLocalDay","crmTaskViewPlan","view","options","uid","today","tomorrow","status","assigneeUid","direction","dueBefore","dueFrom","orderTaskRows","rows","dated","undated","row","dueAtMs","push","TASK_DUE_COLORS","overdue","upcoming","none","done","describeTaskDue","task","locale","state","Number","isFinite","due","time","toLocaleTimeString","hour","minute","toLocaleDateString","weekday","month","day","dueAtToLocalInput","ms","pad","value","String","padStart","getHours","getMinutes","localInputToDueAt","text","trim","CRM_TASK_SNOOZE_OPTIONS","CRM_TASK_SNOOZE_DEFAULT_HOUR","snoozeDueAt","option","had","hours","minutes","now","days","taskRecordLink","routes","contactId","kind","href","contact","dealId","deal","companyId","company"],"mappings":"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"}

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

@@ -0,0 +1,28 @@
+/**
+ * @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 tasks CSV — one file from the section's Export button and the bulk
+ * bar's (AGL-2621).
+ *
+ * A task hangs off a contact, a company or a deal by id; the file names
+ * each by the name the list already resolved for the row, so a spreadsheet
+ * reads "Acme" and not a document id. The assignee is written by address
+ * for the same reason. A due date is an INSTANT — a task due at nine is due
+ * at nine in the assignee's zone — so it is written as an ISO timestamp,
+ * and a spreadsheet renders it in whatever zone it is opened in.
+ */
+export { TASK_CSV_COLUMNS, tasksCsv, type TaskCsvOptions, type TaskCsvRow, } from '@aglyn/aglyn';