@talkpilot/core-db 1.3.6 → 1.3.8

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 +243 -190
  4. package/README_OLD.md +160 -160
  5. package/dist/municipal/tickets/tickets.statistics.getters.d.ts +4 -0
  6. package/dist/municipal/tickets/tickets.statistics.getters.d.ts.map +1 -1
  7. package/dist/municipal/tickets/tickets.statistics.getters.js +30 -3
  8. package/dist/municipal/tickets/tickets.statistics.getters.js.map +1 -1
  9. package/dist/talkpilot/calls/calls.dashboard.d.ts +3 -0
  10. package/dist/talkpilot/calls/calls.dashboard.d.ts.map +1 -0
  11. package/dist/talkpilot/calls/calls.dashboard.js +191 -0
  12. package/dist/talkpilot/calls/calls.dashboard.js.map +1 -0
  13. package/dist/talkpilot/calls/calls.statistics.getters.js +12 -15
  14. package/dist/talkpilot/calls/calls.statistics.getters.js.map +1 -1
  15. package/dist/talkpilot/calls/calls.statistics.types.d.ts +4 -1
  16. package/dist/talkpilot/calls/calls.statistics.types.d.ts.map +1 -1
  17. package/dist/talkpilot/flows/flows.schema.d.ts +3 -0
  18. package/dist/talkpilot/flows/flows.schema.d.ts.map +1 -1
  19. package/dist/talkpilot/flows/flows.schema.js +1 -0
  20. package/dist/talkpilot/flows/flows.schema.js.map +1 -1
  21. package/dist/talkpilot/flows/flows.types.d.ts +1 -0
  22. package/dist/talkpilot/flows/flows.types.d.ts.map +1 -1
  23. package/jest.config.js +20 -20
  24. package/package.json +46 -46
  25. package/src/connection.ts +54 -54
  26. package/src/index.ts +26 -26
  27. package/src/municipal/index.ts +22 -22
  28. package/src/municipal/muniIssues/__tests__/muniIssues.setters.spec.ts +92 -92
  29. package/src/municipal/muniIssues/__tests__/muniIssues.setup.spec.ts +92 -92
  30. package/src/municipal/muniIssues/index.ts +17 -17
  31. package/src/municipal/muniIssues/muniIssues.constants.ts +18 -18
  32. package/src/municipal/muniIssues/muniIssues.getters.ts +24 -24
  33. package/src/municipal/muniIssues/muniIssues.schema.ts +66 -66
  34. package/src/municipal/muniIssues/muniIssues.setters.ts +24 -24
  35. package/src/municipal/muniIssues/muniIssues.setup.ts +65 -65
  36. package/src/municipal/muniIssues/muniIssues.types.ts +37 -37
  37. package/src/municipal/tickets/__tests__/tickets.getters.spec.ts +30 -30
  38. package/src/municipal/tickets/__tests__/tickets.statistics.spec.ts +68 -51
  39. package/src/municipal/tickets/index.ts +3 -3
  40. package/src/municipal/tickets/tickets.constants.ts +8 -8
  41. package/src/municipal/tickets/tickets.getters.ts +121 -121
  42. package/src/municipal/tickets/tickets.statistics.aggregation.ts +96 -96
  43. package/src/municipal/tickets/tickets.statistics.getters.ts +109 -71
  44. package/src/municipal/tickets/tickets.types.ts +53 -53
  45. package/src/talkpilot/calls/__tests__/calls.dashboard.spec.ts +149 -149
  46. package/src/talkpilot/calls/__tests__/calls.statistics.spec.ts +351 -344
  47. package/src/talkpilot/calls/calls.constants.ts +20 -20
  48. package/src/talkpilot/calls/calls.statistics.getters.ts +587 -587
  49. package/src/talkpilot/calls/calls.statistics.types.ts +47 -44
  50. package/src/talkpilot/calls/calls.types.ts +119 -119
  51. package/src/talkpilot/calls/dashboard/calls.dashboard.ts +292 -292
  52. package/src/talkpilot/calls/dashboard/calls.dashboard.types.ts +57 -57
  53. package/src/talkpilot/calls/index.ts +6 -6
  54. package/src/talkpilot/clientsConfig/__tests__/clientsConfig.spec.ts +190 -190
  55. package/src/talkpilot/contextNotes/__tests__/contextNotes.getters.spec.ts +176 -176
  56. package/src/talkpilot/contextNotes/contextNotes.getters.ts +86 -86
  57. package/src/talkpilot/contextNotes/contextNotes.types.ts +20 -20
  58. package/src/talkpilot/contextNotes/index.ts +2 -2
  59. package/src/talkpilot/flows/__tests__/flows.schema.spec.ts +96 -71
  60. package/src/talkpilot/flows/flows.schema.ts +154 -153
  61. package/src/talkpilot/flows/flows.types.ts +187 -186
  62. package/src/talkpilot/index.ts +31 -31
  63. package/src/talkpilot/products/__tests__/products.getters.spec.ts +45 -45
  64. package/src/talkpilot/products/index.ts +2 -2
  65. package/src/talkpilot/products/products.getters.ts +12 -12
  66. package/src/talkpilot/products/products.types.ts +9 -9
  67. package/src/test-utils/db-utils.ts +26 -26
  68. package/src/test-utils/factories/index.ts +15 -15
  69. package/src/test-utils/factories/municipal/muniIssues.ts +32 -32
  70. package/src/test-utils/factories/talkpilot/contextNotes.ts +33 -33
  71. package/src/test-utils/factories/websitalk/scans.ts +23 -23
  72. package/src/utils/date.utils.ts +116 -116
  73. package/src/websitalk/index.ts +15 -15
  74. package/src/websitalk/mongodb-client.ts +61 -61
  75. package/src/websitalk/scans/__tests__/scans.spec.ts +218 -218
  76. package/src/websitalk/scans/index.ts +2 -2
  77. package/src/websitalk/scans/scans.getters.ts +113 -113
  78. package/src/websitalk/scans/scans.types.ts +53 -53
  79. package/tsconfig.json +23 -23
@@ -1,44 +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
- callSidsWithTickets?: string[];
15
- /** Call SIDs whose municipal ticket matches the draft-ticket definition (see tickets statistics getters). */
16
- callSidsWithDraftTickets?: string[];
17
- ticketStatusFilters?: TicketStatusFilter[];
18
- };
19
-
20
- export type CallsSummaryAggregation = {
21
- totalCalls: number;
22
- avgDurationSeconds: number;
23
- openTickets: number;
24
- draftTickets: number;
25
- };
26
-
27
- export type CallsTrendBucket = {
28
- /** Day: YYYY-MM-DD; week: YYYY-MM-DD/YYYY-MM-DD (inclusive, clipped to filter); month: YYYY-MM-01 */
29
- bucket: string;
30
- totalCalls: number;
31
- openTickets: number;
32
- };
33
-
34
- export type CallsHourlyBucket = {
35
- hour: number;
36
- totalCalls: number;
37
- avgCalls: number;
38
- };
39
-
40
- export type CallsRoutingAggregation = {
41
- aiHandled: number;
42
- transferred: number;
43
- hijacked: number;
44
- };
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
+ };