@talkpilot/core-db 1.3.8 → 1.3.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (97) hide show
  1. package/.claude/settings.local.json +11 -0
  2. package/.cursor/rules/development.mdc +65 -65
  3. package/DEVELOPMENT.md +141 -141
  4. package/README.md +257 -243
  5. package/README_OLD.md +160 -160
  6. package/dist/municipal/tickets/tickets.deprecated.getters.d.ts +12 -0
  7. package/dist/municipal/tickets/tickets.deprecated.getters.d.ts.map +1 -0
  8. package/dist/municipal/tickets/tickets.deprecated.getters.js +131 -0
  9. package/dist/municipal/tickets/tickets.deprecated.getters.js.map +1 -0
  10. package/dist/municipal/tickets/tickets.statistics.dates.d.ts +7 -0
  11. package/dist/municipal/tickets/tickets.statistics.dates.d.ts.map +1 -0
  12. package/dist/municipal/tickets/tickets.statistics.dates.js +40 -0
  13. package/dist/municipal/tickets/tickets.statistics.dates.js.map +1 -0
  14. package/dist/municipal/tickets/tickets.statistics.pipeline.d.ts +53 -0
  15. package/dist/municipal/tickets/tickets.statistics.pipeline.d.ts.map +1 -0
  16. package/dist/municipal/tickets/tickets.statistics.pipeline.js +112 -0
  17. package/dist/municipal/tickets/tickets.statistics.pipeline.js.map +1 -0
  18. package/dist/municipal/tickets/tickets.statistics.utils.d.ts +7 -0
  19. package/dist/municipal/tickets/tickets.statistics.utils.d.ts.map +1 -0
  20. package/dist/municipal/tickets/tickets.statistics.utils.js +40 -0
  21. package/dist/municipal/tickets/tickets.statistics.utils.js.map +1 -0
  22. package/dist/talkpilot/calls/calls.statistics.getters.d.ts.map +1 -1
  23. package/dist/talkpilot/calls/calls.statistics.getters.js +6 -3
  24. package/dist/talkpilot/calls/calls.statistics.getters.js.map +1 -1
  25. package/dist/talkpilot/calls/calls.statistics.ticketScope.d.ts +12 -0
  26. package/dist/talkpilot/calls/calls.statistics.ticketScope.d.ts.map +1 -0
  27. package/dist/talkpilot/calls/calls.statistics.ticketScope.js +37 -0
  28. package/dist/talkpilot/calls/calls.statistics.ticketScope.js.map +1 -0
  29. package/dist/talkpilot/calls/calls.statistics.tickets.d.ts +17 -0
  30. package/dist/talkpilot/calls/calls.statistics.tickets.d.ts.map +1 -0
  31. package/dist/talkpilot/calls/calls.statistics.tickets.js +33 -0
  32. package/dist/talkpilot/calls/calls.statistics.tickets.js.map +1 -0
  33. package/dist/utils/statistics.aggregation.d.ts +20 -0
  34. package/dist/utils/statistics.aggregation.d.ts.map +1 -0
  35. package/dist/utils/statistics.aggregation.js +43 -0
  36. package/dist/utils/statistics.aggregation.js.map +1 -0
  37. package/jest.config.js +20 -20
  38. package/package.json +46 -46
  39. package/src/connection.ts +54 -54
  40. package/src/index.ts +26 -26
  41. package/src/municipal/index.ts +22 -22
  42. package/src/municipal/muniIssues/__tests__/muniIssues.setters.spec.ts +92 -92
  43. package/src/municipal/muniIssues/__tests__/muniIssues.setup.spec.ts +92 -92
  44. package/src/municipal/muniIssues/index.ts +17 -17
  45. package/src/municipal/muniIssues/muniIssues.constants.ts +18 -18
  46. package/src/municipal/muniIssues/muniIssues.getters.ts +24 -24
  47. package/src/municipal/muniIssues/muniIssues.schema.ts +66 -66
  48. package/src/municipal/muniIssues/muniIssues.setters.ts +24 -24
  49. package/src/municipal/muniIssues/muniIssues.setup.ts +65 -65
  50. package/src/municipal/muniIssues/muniIssues.types.ts +37 -37
  51. package/src/municipal/tickets/__tests__/tickets.getters.spec.ts +30 -30
  52. package/src/municipal/tickets/__tests__/tickets.statistics.spec.ts +68 -68
  53. package/src/municipal/tickets/index.ts +3 -3
  54. package/src/municipal/tickets/tickets.constants.ts +8 -8
  55. package/src/municipal/tickets/tickets.getters.ts +121 -121
  56. package/src/municipal/tickets/tickets.statistics.aggregation.ts +96 -96
  57. package/src/municipal/tickets/tickets.statistics.getters.ts +109 -109
  58. package/src/municipal/tickets/tickets.types.ts +53 -53
  59. package/src/talkpilot/calls/__tests__/calls.dashboard.spec.ts +149 -149
  60. package/src/talkpilot/calls/__tests__/calls.statistics.spec.ts +375 -351
  61. package/src/talkpilot/calls/calls.constants.ts +20 -20
  62. package/src/talkpilot/calls/calls.statistics.getters.ts +590 -587
  63. package/src/talkpilot/calls/calls.statistics.types.ts +47 -47
  64. package/src/talkpilot/calls/calls.types.ts +119 -119
  65. package/src/talkpilot/calls/dashboard/calls.dashboard.ts +292 -292
  66. package/src/talkpilot/calls/dashboard/calls.dashboard.types.ts +57 -57
  67. package/src/talkpilot/calls/index.ts +6 -6
  68. package/src/talkpilot/clientsConfig/__tests__/clientsConfig.spec.ts +190 -190
  69. package/src/talkpilot/contextNotes/__tests__/contextNotes.getters.spec.ts +176 -176
  70. package/src/talkpilot/contextNotes/contextNotes.getters.ts +86 -86
  71. package/src/talkpilot/contextNotes/contextNotes.types.ts +20 -20
  72. package/src/talkpilot/contextNotes/index.ts +2 -2
  73. package/src/talkpilot/flows/__tests__/flows.schema.spec.ts +96 -96
  74. package/src/talkpilot/flows/flows.schema.ts +154 -154
  75. package/src/talkpilot/flows/flows.types.ts +187 -187
  76. package/src/talkpilot/index.ts +31 -31
  77. package/src/talkpilot/products/__tests__/products.getters.spec.ts +45 -45
  78. package/src/talkpilot/products/index.ts +2 -2
  79. package/src/talkpilot/products/products.getters.ts +12 -12
  80. package/src/talkpilot/products/products.types.ts +9 -9
  81. package/src/test-utils/db-utils.ts +26 -26
  82. package/src/test-utils/factories/index.ts +15 -15
  83. package/src/test-utils/factories/municipal/muniIssues.ts +32 -32
  84. package/src/test-utils/factories/talkpilot/contextNotes.ts +33 -33
  85. package/src/test-utils/factories/websitalk/scans.ts +23 -23
  86. package/src/utils/date.utils.ts +116 -116
  87. package/src/websitalk/index.ts +15 -15
  88. package/src/websitalk/mongodb-client.ts +61 -61
  89. package/src/websitalk/scans/__tests__/scans.spec.ts +218 -218
  90. package/src/websitalk/scans/index.ts +2 -2
  91. package/src/websitalk/scans/scans.getters.ts +113 -113
  92. package/src/websitalk/scans/scans.types.ts +53 -53
  93. package/tsconfig.json +23 -23
  94. package/dist/talkpilot/calls/calls.dashboard.d.ts +0 -3
  95. package/dist/talkpilot/calls/calls.dashboard.d.ts.map +0 -1
  96. package/dist/talkpilot/calls/calls.dashboard.js +0 -191
  97. package/dist/talkpilot/calls/calls.dashboard.js.map +0 -1
@@ -1,47 +1,47 @@
1
- export type ResolvedTimeBucket = "day" | "week" | "month";
2
-
3
- export type TicketStatusFilter = "opened" | "not_opened";
4
- export type CallRoutingFilter = "ai_only" | "transferred" | "hijacked";
5
-
6
- export type CallsStatsFilter = {
7
- clientId: string;
8
- startStr: string;
9
- endStr: string;
10
- timezone: string;
11
- hourFrom?: string; // HH:mm
12
- hourTo?: string; // HH:mm
13
- callRouting?: CallRoutingFilter[];
14
- /** @deprecated Use callSidTicketCounts instead. */
15
- callSidsWithTickets?: string[];
16
- callSidTicketCounts?: Map<string, number>;
17
- /** @deprecated Use callSidDraftTicketCounts instead. */
18
- callSidsWithDraftTickets?: string[];
19
- callSidDraftTicketCounts?: Map<string, number>;
20
- ticketStatusFilters?: TicketStatusFilter[];
21
- };
22
-
23
- export type CallsSummaryAggregation = {
24
- totalCalls: number;
25
- avgDurationSeconds: number;
26
- openTickets: number;
27
- draftTickets: number;
28
- };
29
-
30
- export type CallsTrendBucket = {
31
- /** Day: YYYY-MM-DD; week: YYYY-MM-DD/YYYY-MM-DD (inclusive, clipped to filter); month: YYYY-MM-01 */
32
- bucket: string;
33
- totalCalls: number;
34
- openTickets: number;
35
- };
36
-
37
- export type CallsHourlyBucket = {
38
- hour: number;
39
- totalCalls: number;
40
- avgCalls: number;
41
- };
42
-
43
- export type CallsRoutingAggregation = {
44
- aiHandled: number;
45
- transferred: number;
46
- hijacked: number;
47
- };
1
+ export type ResolvedTimeBucket = "day" | "week" | "month";
2
+
3
+ export type TicketStatusFilter = "opened" | "not_opened";
4
+ export type CallRoutingFilter = "ai_only" | "transferred" | "hijacked";
5
+
6
+ export type CallsStatsFilter = {
7
+ clientId: string;
8
+ startStr: string;
9
+ endStr: string;
10
+ timezone: string;
11
+ hourFrom?: string; // HH:mm
12
+ hourTo?: string; // HH:mm
13
+ callRouting?: CallRoutingFilter[];
14
+ /** @deprecated Use callSidTicketCounts instead. */
15
+ callSidsWithTickets?: string[];
16
+ callSidTicketCounts?: Map<string, number>;
17
+ /** @deprecated Use callSidDraftTicketCounts instead. */
18
+ callSidsWithDraftTickets?: string[];
19
+ callSidDraftTicketCounts?: Map<string, number>;
20
+ ticketStatusFilters?: TicketStatusFilter[];
21
+ };
22
+
23
+ export type CallsSummaryAggregation = {
24
+ totalCalls: number;
25
+ avgDurationSeconds: number;
26
+ openTickets: number;
27
+ draftTickets: number;
28
+ };
29
+
30
+ export type CallsTrendBucket = {
31
+ /** Day: YYYY-MM-DD; week: YYYY-MM-DD/YYYY-MM-DD (inclusive, clipped to filter); month: YYYY-MM-01 */
32
+ bucket: string;
33
+ totalCalls: number;
34
+ openTickets: number;
35
+ };
36
+
37
+ export type CallsHourlyBucket = {
38
+ hour: number;
39
+ totalCalls: number;
40
+ avgCalls: number;
41
+ };
42
+
43
+ export type CallsRoutingAggregation = {
44
+ aiHandled: number;
45
+ transferred: number;
46
+ hijacked: number;
47
+ };
@@ -1,119 +1,119 @@
1
- import { ObjectId, Sort, WithId } from "mongodb";
2
- import { TranscriptionSegment } from "../results";
3
- import { LeadProperty } from "../leads";
4
-
5
- import {
6
- CONFERENCE_ROLE_CUSTOMER,
7
- CONFERENCE_ROLE_SUPERVISOR,
8
- } from "./calls.constants";
9
-
10
- export type ConferenceRole =
11
- | typeof CONFERENCE_ROLE_CUSTOMER
12
- | typeof CONFERENCE_ROLE_SUPERVISOR
13
- | null;
14
-
15
- export type Call = {
16
- callSid: string;
17
- flowId: ObjectId;
18
- clientId: string;
19
- sessionId: ObjectId | null;
20
- runId?: string;
21
- resultId: ObjectId;
22
- customerPhoneNumber: string;
23
- agentPhoneNumber: string;
24
- isIncomingCall: boolean;
25
- isOutgoingCall: boolean;
26
- callLength: number;
27
- transcription?: TranscriptionSegment[];
28
- status?: string;
29
- leads?: LeadProperty[];
30
- summary?: string;
31
- recordingUrl?: string;
32
- env: string;
33
- updatedAt: Date;
34
- createdAt: Date;
35
- isAnsweredByAnsweringMachine?: boolean;
36
- agentHungUp?: boolean;
37
- endReason?: string;
38
- conferenceName?: string | null;
39
- conferenceSid?: string | null;
40
- conferenceParticipantSid?: string | null;
41
- isConferenceCall?: boolean;
42
- conferenceRole?: ConferenceRole;
43
- redirectedCall?: boolean;
44
- toolExecutions?: ToolExecution[];
45
- };
46
-
47
- export type ToolExecution = {
48
- toolName: string;
49
- executedAt: Date;
50
- durationMs: number;
51
- args: Record<string, unknown> | { _redacted: true };
52
- meta: ToolExecutionMeta;
53
- status: "success" | "error";
54
- httpStatus?: number;
55
- response?: Record<string, unknown>;
56
- };
57
-
58
- export type ToolExecutionMeta =
59
- | {
60
- kind: "http";
61
- url: string;
62
- method: string;
63
- flowToolId?: string;
64
- runInBackground?: boolean;
65
- sensitive?: boolean;
66
- }
67
- | { kind: "internal" };
68
-
69
- export type CallQueryOptions = {
70
- sort?: Sort;
71
- skip?: number;
72
- limit?: number;
73
- };
74
-
75
- export type CallsFilterParams = {
76
- clientId: string;
77
- callSid?: string;
78
- startDate?: Date;
79
- endDate?: Date;
80
- status?: string;
81
- customerPhoneNumber?: string;
82
- agentPhoneNumber?: string;
83
- flowId?: string;
84
- runId?: string;
85
- sessionId?: string;
86
- isIncoming?: boolean;
87
- search?: string;
88
- };
89
-
90
- export type ImmutableCallFields =
91
- | "customerPhoneNumber"
92
- | "agentPhoneNumber"
93
- | "isIncomingCall"
94
- | "isOutgoingCall"
95
- | "sessionId"
96
- | "callSid"
97
- | "flowId"
98
- | "clientId"
99
- | "runId"
100
- | "resultId"
101
- | "env"
102
- | "createdAt";
103
-
104
- export type CallUpdateParams = Partial<Omit<Call, ImmutableCallFields>>;
105
-
106
- export type CallDoc = WithId<Call>;
107
-
108
- /** @deprecated use DashboardHeatmapMetric instead */
109
- export type CallsByHour = { hour: number; calls: number };
110
-
111
- export type CountOpts = {
112
- isOutgoingCall?: boolean;
113
- isIncomingCall?: boolean;
114
- };
115
-
116
- export type DateRange = {
117
- since?: Date;
118
- until?: Date;
119
- };
1
+ import { ObjectId, Sort, WithId } from "mongodb";
2
+ import { TranscriptionSegment } from "../results";
3
+ import { LeadProperty } from "../leads";
4
+
5
+ import {
6
+ CONFERENCE_ROLE_CUSTOMER,
7
+ CONFERENCE_ROLE_SUPERVISOR,
8
+ } from "./calls.constants";
9
+
10
+ export type ConferenceRole =
11
+ | typeof CONFERENCE_ROLE_CUSTOMER
12
+ | typeof CONFERENCE_ROLE_SUPERVISOR
13
+ | null;
14
+
15
+ export type Call = {
16
+ callSid: string;
17
+ flowId: ObjectId;
18
+ clientId: string;
19
+ sessionId: ObjectId | null;
20
+ runId?: string;
21
+ resultId: ObjectId;
22
+ customerPhoneNumber: string;
23
+ agentPhoneNumber: string;
24
+ isIncomingCall: boolean;
25
+ isOutgoingCall: boolean;
26
+ callLength: number;
27
+ transcription?: TranscriptionSegment[];
28
+ status?: string;
29
+ leads?: LeadProperty[];
30
+ summary?: string;
31
+ recordingUrl?: string;
32
+ env: string;
33
+ updatedAt: Date;
34
+ createdAt: Date;
35
+ isAnsweredByAnsweringMachine?: boolean;
36
+ agentHungUp?: boolean;
37
+ endReason?: string;
38
+ conferenceName?: string | null;
39
+ conferenceSid?: string | null;
40
+ conferenceParticipantSid?: string | null;
41
+ isConferenceCall?: boolean;
42
+ conferenceRole?: ConferenceRole;
43
+ redirectedCall?: boolean;
44
+ toolExecutions?: ToolExecution[];
45
+ };
46
+
47
+ export type ToolExecution = {
48
+ toolName: string;
49
+ executedAt: Date;
50
+ durationMs: number;
51
+ args: Record<string, unknown> | { _redacted: true };
52
+ meta: ToolExecutionMeta;
53
+ status: "success" | "error";
54
+ httpStatus?: number;
55
+ response?: Record<string, unknown>;
56
+ };
57
+
58
+ export type ToolExecutionMeta =
59
+ | {
60
+ kind: "http";
61
+ url: string;
62
+ method: string;
63
+ flowToolId?: string;
64
+ runInBackground?: boolean;
65
+ sensitive?: boolean;
66
+ }
67
+ | { kind: "internal" };
68
+
69
+ export type CallQueryOptions = {
70
+ sort?: Sort;
71
+ skip?: number;
72
+ limit?: number;
73
+ };
74
+
75
+ export type CallsFilterParams = {
76
+ clientId: string;
77
+ callSid?: string;
78
+ startDate?: Date;
79
+ endDate?: Date;
80
+ status?: string;
81
+ customerPhoneNumber?: string;
82
+ agentPhoneNumber?: string;
83
+ flowId?: string;
84
+ runId?: string;
85
+ sessionId?: string;
86
+ isIncoming?: boolean;
87
+ search?: string;
88
+ };
89
+
90
+ export type ImmutableCallFields =
91
+ | "customerPhoneNumber"
92
+ | "agentPhoneNumber"
93
+ | "isIncomingCall"
94
+ | "isOutgoingCall"
95
+ | "sessionId"
96
+ | "callSid"
97
+ | "flowId"
98
+ | "clientId"
99
+ | "runId"
100
+ | "resultId"
101
+ | "env"
102
+ | "createdAt";
103
+
104
+ export type CallUpdateParams = Partial<Omit<Call, ImmutableCallFields>>;
105
+
106
+ export type CallDoc = WithId<Call>;
107
+
108
+ /** @deprecated use DashboardHeatmapMetric instead */
109
+ export type CallsByHour = { hour: number; calls: number };
110
+
111
+ export type CountOpts = {
112
+ isOutgoingCall?: boolean;
113
+ isIncomingCall?: boolean;
114
+ };
115
+
116
+ export type DateRange = {
117
+ since?: Date;
118
+ until?: Date;
119
+ };