@talkpilot/core-db 1.3.8 → 1.3.11

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 (79) hide show
  1. package/.cursor/rules/development.mdc +65 -65
  2. package/DEVELOPMENT.md +141 -141
  3. package/README.md +287 -243
  4. package/README_OLD.md +160 -160
  5. package/dist/municipal/tickets/tickets.statistics.aggregation.d.ts +34 -0
  6. package/dist/municipal/tickets/tickets.statistics.aggregation.d.ts.map +1 -1
  7. package/dist/municipal/tickets/tickets.statistics.aggregation.js +14 -1
  8. package/dist/municipal/tickets/tickets.statistics.aggregation.js.map +1 -1
  9. package/dist/municipal/tickets/tickets.statistics.getters.js +2 -2
  10. package/dist/municipal/tickets/tickets.statistics.getters.js.map +1 -1
  11. package/dist/municipal/tickets/tickets.types.d.ts +1 -0
  12. package/dist/municipal/tickets/tickets.types.d.ts.map +1 -1
  13. package/dist/talkpilot/calls/calls.statistics.getters.d.ts.map +1 -1
  14. package/dist/talkpilot/calls/calls.statistics.getters.js +6 -3
  15. package/dist/talkpilot/calls/calls.statistics.getters.js.map +1 -1
  16. package/dist/talkpilot/clientsConfig/clientsConfig.types.d.ts +1 -1
  17. package/dist/talkpilot/clientsConfig/clientsConfig.types.d.ts.map +1 -1
  18. package/jest.config.js +20 -20
  19. package/package.json +46 -46
  20. package/src/connection.ts +54 -54
  21. package/src/index.ts +26 -26
  22. package/src/municipal/index.ts +22 -22
  23. package/src/municipal/muniIssues/__tests__/muniIssues.setters.spec.ts +92 -92
  24. package/src/municipal/muniIssues/__tests__/muniIssues.setup.spec.ts +92 -92
  25. package/src/municipal/muniIssues/index.ts +17 -17
  26. package/src/municipal/muniIssues/muniIssues.constants.ts +18 -18
  27. package/src/municipal/muniIssues/muniIssues.getters.ts +24 -24
  28. package/src/municipal/muniIssues/muniIssues.schema.ts +66 -66
  29. package/src/municipal/muniIssues/muniIssues.setters.ts +24 -24
  30. package/src/municipal/muniIssues/muniIssues.setup.ts +65 -65
  31. package/src/municipal/muniIssues/muniIssues.types.ts +37 -37
  32. package/src/municipal/tickets/__tests__/tickets.getters.spec.ts +30 -30
  33. package/src/municipal/tickets/__tests__/tickets.statistics.spec.ts +94 -68
  34. package/src/municipal/tickets/index.ts +3 -3
  35. package/src/municipal/tickets/tickets.constants.ts +8 -8
  36. package/src/municipal/tickets/tickets.getters.ts +121 -121
  37. package/src/municipal/tickets/tickets.statistics.aggregation.ts +110 -96
  38. package/src/municipal/tickets/tickets.statistics.getters.ts +109 -109
  39. package/src/municipal/tickets/tickets.types.ts +54 -53
  40. package/src/talkpilot/calls/__tests__/calls.dashboard.spec.ts +149 -149
  41. package/src/talkpilot/calls/__tests__/calls.statistics.spec.ts +375 -351
  42. package/src/talkpilot/calls/calls.constants.ts +20 -20
  43. package/src/talkpilot/calls/calls.statistics.getters.ts +590 -587
  44. package/src/talkpilot/calls/calls.statistics.types.ts +47 -47
  45. package/src/talkpilot/calls/calls.types.ts +119 -119
  46. package/src/talkpilot/calls/dashboard/calls.dashboard.ts +292 -292
  47. package/src/talkpilot/calls/dashboard/calls.dashboard.types.ts +57 -57
  48. package/src/talkpilot/calls/index.ts +6 -6
  49. package/src/talkpilot/clientsConfig/__tests__/clientsConfig.spec.ts +190 -190
  50. package/src/talkpilot/clientsConfig/clientsConfig.types.ts +1 -1
  51. package/src/talkpilot/contextNotes/__tests__/contextNotes.getters.spec.ts +176 -176
  52. package/src/talkpilot/contextNotes/contextNotes.getters.ts +86 -86
  53. package/src/talkpilot/contextNotes/contextNotes.types.ts +20 -20
  54. package/src/talkpilot/contextNotes/index.ts +2 -2
  55. package/src/talkpilot/flows/__tests__/flows.schema.spec.ts +96 -96
  56. package/src/talkpilot/flows/flows.schema.ts +154 -154
  57. package/src/talkpilot/flows/flows.types.ts +187 -187
  58. package/src/talkpilot/index.ts +31 -31
  59. package/src/talkpilot/products/__tests__/products.getters.spec.ts +45 -45
  60. package/src/talkpilot/products/index.ts +2 -2
  61. package/src/talkpilot/products/products.getters.ts +12 -12
  62. package/src/talkpilot/products/products.types.ts +9 -9
  63. package/src/test-utils/db-utils.ts +26 -26
  64. package/src/test-utils/factories/index.ts +15 -15
  65. package/src/test-utils/factories/municipal/muniIssues.ts +32 -32
  66. package/src/test-utils/factories/talkpilot/contextNotes.ts +33 -33
  67. package/src/test-utils/factories/websitalk/scans.ts +23 -23
  68. package/src/utils/date.utils.ts +116 -116
  69. package/src/websitalk/index.ts +15 -15
  70. package/src/websitalk/mongodb-client.ts +61 -61
  71. package/src/websitalk/scans/__tests__/scans.spec.ts +218 -218
  72. package/src/websitalk/scans/index.ts +2 -2
  73. package/src/websitalk/scans/scans.getters.ts +113 -113
  74. package/src/websitalk/scans/scans.types.ts +53 -53
  75. package/tsconfig.json +23 -23
  76. package/dist/talkpilot/calls/calls.dashboard.d.ts +0 -3
  77. package/dist/talkpilot/calls/calls.dashboard.d.ts.map +0 -1
  78. package/dist/talkpilot/calls/calls.dashboard.js +0 -191
  79. 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
+ };