tasks.ts

packages/bitrix-client/src/tasks.ts

1. /**
2. * Bitrix tasks: the only source that can see people who hold neither orders
3. * nor tracker rows.
4. *
5. * A warning about this data: most of the oldest open tasks are junk, such as
6. * duplicate entries from a runaway automation, rows titled "test", Bitrix
7. * onboarding defaults nobody ever completed ("Fill out profile", "Invite
8. * colleagues", "Download Bitrix24 application") and demos, some overdue by
9. * a year.
10. *
11. * So a raw task count is not a workload signal; it is mostly automation exhaust.
12. * Junk is flagged and excluded from the count, and the excluded number is shown
13. * on the page. Silent filtering is how a dashboard starts lying, and a count
14. * dominated by one broken automation is how it loses its audience.
15. */
17. import type { BitrixClient } from './http.js'
19. export interface RawTask {
20. id?: string | number
21. title?: string
22. responsibleId?: string | number
23. RESPONSIBLE_ID?: string | number
24. TITLE?: string
25. ID?: string | number
26. deadline?: string | null
27. DEADLINE?: string | null
28. status?: string | number
29. STATUS?: string | number
30. createdDate?: string
31. CREATED_DATE?: string
32. }
34. export interface Task {
35. id: string
36. title: string
37. responsibleId: string | null
38. deadline: string | null
39. createdAt: string | null
40. ageDays: number | null
41. overdue: boolean
42. junk: boolean
43. junkReason: string | null
44. }
46. /**
47. * Patterns confirmed against the live open-task list. Conservative: each one
48. * matches something unambiguous, because a real task wrongly hidden is worse
49. * than a noisy row shown.
50. */
51. const JUNK_PATTERNS: { re: RegExp; reason: string }[] = [
52. { re: /^FedEx Invoice Review$/i, reason: 'runaway automation: 16 identical copies' },
53. { re: /^test$/i, reason: 'test task' },
54. { re: /^(Demo - Task|Task Demo)$/i, reason: 'demo task' },
55. { re: /^Fill out profile$/i, reason: 'Bitrix onboarding default' },
56. { re: /^Invite colleagues$/i, reason: 'Bitrix onboarding default' },
57. { re: /^Download Bitrix24 application$/i, reason: 'Bitrix onboarding default' },
58. ]
60. export function isJunkTask(title: string): { junk: boolean; reason: string | null } {
61. for (const p of JUNK_PATTERNS) if (p.re.test(title.trim())) return { junk: true, reason: p.reason }
62. return { junk: false, reason: null }
63. }
65. const pick = <T>(...v: (T | undefined | null)[]) => v.find((x) => x !== undefined && x !== null) ?? null
67. export function normalizeTask(raw: RawTask, now = new Date()): Task {
68. const title = String(pick(raw.title, raw.TITLE) ?? '').trim() || '(untitled)'
69. const { junk, reason } = isJunkTask(title)
70. const deadline = pick(raw.deadline, raw.DEADLINE)
71. const created = pick(raw.createdDate, raw.CREATED_DATE)
72. const responsible = pick(raw.responsibleId, raw.RESPONSIBLE_ID)
74. return {
75. id: String(pick(raw.id, raw.ID) ?? ''),
76. title,
77. responsibleId: responsible !== null ? String(responsible) : null,
78. deadline: deadline ?? null,
79. createdAt: created ?? null,
80. ageDays: created ? Math.floor((now.getTime() - Date.parse(created)) / 86_400_000) : null,
81. overdue: deadline ? Date.parse(deadline) < now.getTime() : false,
82. junk,
83. junkReason: reason,
84. }
85. }
87. export class TasksResource {
88. constructor(private readonly http: BitrixClient) {}
90. /**
91. * Every open task across the company, not just the caller's.
92. *
93. * `tasks.task.list` nests results under `result.tasks` rather than returning a
94. * bare array like the crm.* methods, which is why this does not use listAll.
95. */
96. async listOpen(now = new Date()): Promise<Task[]> {
97. const page = await this.http.call<{ tasks?: RawTask[] }>('tasks.task.list', {
98. filter: { '<REAL_STATUS': 5 }, // anything not completed
99. select: ['ID', 'TITLE', 'RESPONSIBLE_ID', 'DEADLINE', 'STATUS', 'CREATED_DATE'],
100. order: { DEADLINE: 'asc' },
101. })
102. const rows = page.result?.tasks ?? []
103. return rows.map((r) => normalizeTask(r, now))
104. }
105. }
107. /** Split real work from automation exhaust, keeping the excluded count visible. */
108. export function partitionTasks(tasks: Task[]): { real: Task[]; junk: Task[] } {
109. return {
110. real: tasks.filter((t) => !t.junk),
111. junk: tasks.filter((t) => t.junk),
112. }
113. }