@talkpilot/core-db 1.1.19 → 1.2.0

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 (130) hide show
  1. package/.cursor/rules/development.mdc +65 -65
  2. package/DEVELOPMENT.md +98 -98
  3. package/README.md +160 -160
  4. package/dist/talkpilot/calls/calls.getters.d.ts +2 -1
  5. package/dist/talkpilot/calls/calls.getters.d.ts.map +1 -1
  6. package/dist/talkpilot/calls/calls.getters.js +176 -0
  7. package/dist/talkpilot/calls/calls.getters.js.map +1 -1
  8. package/dist/talkpilot/calls/calls.types.d.ts +48 -0
  9. package/dist/talkpilot/calls/calls.types.d.ts.map +1 -1
  10. package/dist/talkpilot/clientsConfig/clientsConfig.getters.d.ts +1 -0
  11. package/dist/talkpilot/clientsConfig/clientsConfig.getters.d.ts.map +1 -1
  12. package/dist/talkpilot/clientsConfig/clientsConfig.getters.js +13 -0
  13. package/dist/talkpilot/clientsConfig/clientsConfig.getters.js.map +1 -1
  14. package/jest.config.js +19 -19
  15. package/package.json +45 -45
  16. package/src/__tests__/setup.ts +20 -20
  17. package/src/connection.ts +42 -42
  18. package/src/index.ts +16 -16
  19. package/src/municipal/__tests__/validation.spec.ts +62 -62
  20. package/src/municipal/cities/cities.getters.ts +50 -50
  21. package/src/municipal/cities/cities.types.ts +11 -11
  22. package/src/municipal/cities/index.ts +2 -2
  23. package/src/municipal/departmentsSubjects/departmentsSubjects.getters.ts +282 -282
  24. package/src/municipal/departmentsSubjects/departmentsSubjects.types.ts +72 -72
  25. package/src/municipal/departmentsSubjects/index.ts +9 -9
  26. package/src/municipal/index.ts +21 -21
  27. package/src/municipal/mongodb-client.ts +61 -61
  28. package/src/municipal/streets/index.ts +2 -2
  29. package/src/municipal/streets/streets.getters.ts +125 -125
  30. package/src/municipal/streets/streets.types.ts +18 -18
  31. package/src/municipal/systemInstructions/__tests__/getters.spec.ts +113 -113
  32. package/src/municipal/systemInstructions/__tests__/setters.spec.ts +274 -274
  33. package/src/municipal/systemInstructions/index.ts +7 -7
  34. package/src/municipal/systemInstructions/instructions.getters.ts +57 -57
  35. package/src/municipal/systemInstructions/instructions.setters.ts +119 -119
  36. package/src/municipal/systemInstructions/instructions.types.ts +30 -30
  37. package/src/municipal/tickets/__tests__/tickets.getters.spec.ts +66 -66
  38. package/src/municipal/tickets/index.ts +2 -2
  39. package/src/municipal/tickets/tickets.getters.ts +261 -261
  40. package/src/municipal/tickets/tickets.types.ts +43 -43
  41. package/src/municipal/utils/types.ts +11 -11
  42. package/src/talkpilot/__tests__/db.spec.ts +38 -38
  43. package/src/talkpilot/__tests__/mongodb-client.spec.ts +18 -18
  44. package/src/talkpilot/__tests__/validation.spec.ts +68 -68
  45. package/src/talkpilot/agents/__tests__/agents.getters.spec.ts +29 -29
  46. package/src/talkpilot/agents/agents.getters.ts +34 -34
  47. package/src/talkpilot/agents/agents.types.ts +14 -14
  48. package/src/talkpilot/agents/index.ts +2 -2
  49. package/src/talkpilot/backgroundToolResults/__tests__/backgroundToolResults.getters.spec.ts +147 -147
  50. package/src/talkpilot/backgroundToolResults/backgroundToolResults.getters.ts +65 -65
  51. package/src/talkpilot/backgroundToolResults/backgroundToolResults.types.ts +23 -23
  52. package/src/talkpilot/backgroundToolResults/index.ts +2 -2
  53. package/src/talkpilot/calls/__tests__/callStats.utils.spec.ts +128 -128
  54. package/src/talkpilot/calls/__tests__/calls.spec.ts +252 -252
  55. package/src/talkpilot/calls/calls.getters.ts +446 -248
  56. package/src/talkpilot/calls/calls.types.ts +171 -115
  57. package/src/talkpilot/calls/index.ts +2 -2
  58. package/src/talkpilot/clientAudioBuffers/__tests__/clientAudioBuffer.getters.spec.ts +160 -160
  59. package/src/talkpilot/clientAudioBuffers/clientAudioBuffer.getters.ts +117 -117
  60. package/src/talkpilot/clientAudioBuffers/clientsAudioBuffers.types.ts +25 -25
  61. package/src/talkpilot/clientAudioBuffers/index.ts +2 -2
  62. package/src/talkpilot/clients/clients.getters.ts +16 -16
  63. package/src/talkpilot/clients/clients.types.ts +14 -14
  64. package/src/talkpilot/clients/index.ts +2 -2
  65. package/src/talkpilot/clientsConfig/__tests__/clientsConfig.spec.ts +106 -106
  66. package/src/talkpilot/clientsConfig/clientsConfig.getters.ts +44 -22
  67. package/src/talkpilot/clientsConfig/clientsConfig.types.ts +94 -94
  68. package/src/talkpilot/clientsConfig/index.ts +2 -2
  69. package/src/talkpilot/flows/__tests__/flows.schema.spec.ts +67 -67
  70. package/src/talkpilot/flows/flows.getter.ts +14 -14
  71. package/src/talkpilot/flows/flows.schema.ts +153 -153
  72. package/src/talkpilot/flows/flows.types.ts +184 -184
  73. package/src/talkpilot/flows/index.ts +2 -2
  74. package/src/talkpilot/groups/__tests__/groups.spec.ts +90 -90
  75. package/src/talkpilot/groups/__tests__/phone.utils.spec.ts +32 -32
  76. package/src/talkpilot/groups/groups.getters.ts +30 -30
  77. package/src/talkpilot/groups/groups.types.ts +29 -29
  78. package/src/talkpilot/groups/index.ts +3 -3
  79. package/src/talkpilot/groups/phone.utils.ts +46 -46
  80. package/src/talkpilot/index.ts +29 -29
  81. package/src/talkpilot/leads/index.ts +2 -2
  82. package/src/talkpilot/leads/leads.getter.ts +6 -6
  83. package/src/talkpilot/leads/leads.schema.ts +33 -33
  84. package/src/talkpilot/leads/leads.types.ts +20 -20
  85. package/src/talkpilot/mongodb-client.ts +78 -78
  86. package/src/talkpilot/phone_numbers/__tests__/phone_numbers.spec.ts +247 -247
  87. package/src/talkpilot/phone_numbers/index.ts +2 -2
  88. package/src/talkpilot/phone_numbers/phone_numbers.getter.ts +154 -154
  89. package/src/talkpilot/phone_numbers/phone_numbers.schema.ts +17 -17
  90. package/src/talkpilot/phone_numbers/phone_numbers.types.ts +30 -30
  91. package/src/talkpilot/plans/__tests__/plans.spec.ts +70 -70
  92. package/src/talkpilot/plans/index.ts +2 -2
  93. package/src/talkpilot/plans/plans.getters.ts +132 -132
  94. package/src/talkpilot/plans/plans.types.ts +89 -89
  95. package/src/talkpilot/results/index.ts +7 -7
  96. package/src/talkpilot/results/results.getter.ts +35 -35
  97. package/src/talkpilot/results/results.schema.ts +25 -25
  98. package/src/talkpilot/results/results.types.ts +34 -34
  99. package/src/talkpilot/retry_analyze/__tests__/retryAnalyze.getters.spec.ts +156 -156
  100. package/src/talkpilot/retry_analyze/index.ts +2 -2
  101. package/src/talkpilot/retry_analyze/retryAnalyze.getters.ts +75 -75
  102. package/src/talkpilot/retry_analyze/retryAnalyze.types.ts +13 -13
  103. package/src/talkpilot/sessions/__tests__/sessions.spec.ts +147 -147
  104. package/src/talkpilot/sessions/index.ts +2 -2
  105. package/src/talkpilot/sessions/sessions.getter.ts +92 -92
  106. package/src/talkpilot/sessions/sessions.schema.ts +34 -34
  107. package/src/talkpilot/sessions/sessions.types.ts +30 -30
  108. package/src/talkpilot/subscriptions/__tests__/subscriptions.getters.utils.spec.ts +45 -45
  109. package/src/talkpilot/subscriptions/index.ts +3 -3
  110. package/src/talkpilot/subscriptions/subscriptions.getters.ts +146 -146
  111. package/src/talkpilot/subscriptions/subscriptions.getters.utils.ts +33 -33
  112. package/src/talkpilot/subscriptions/subscriptions.types.ts +66 -66
  113. package/src/talkpilot/utils/__tests__/query.utils.spec.ts +49 -49
  114. package/src/talkpilot/utils/query.utils.ts +21 -21
  115. package/src/test-utils/db-utils.ts +24 -24
  116. package/src/test-utils/factories/index.ts +12 -12
  117. package/src/test-utils/factories/municipal/cities.ts +16 -16
  118. package/src/test-utils/factories/municipal/departmentsSubjects.ts +37 -37
  119. package/src/test-utils/factories/municipal/streets.ts +22 -22
  120. package/src/test-utils/factories/municipal/tickets.ts +39 -39
  121. package/src/test-utils/factories/talkpilot/agents.ts +19 -19
  122. package/src/test-utils/factories/talkpilot/calls.ts +37 -37
  123. package/src/test-utils/factories/talkpilot/clientAudioBuffers.ts +20 -20
  124. package/src/test-utils/factories/talkpilot/clientsConfig.ts +18 -18
  125. package/src/test-utils/factories/talkpilot/flows.ts +33 -33
  126. package/src/test-utils/factories/talkpilot/groups.ts +33 -33
  127. package/src/test-utils/factories/talkpilot/phone_numbers.ts +22 -22
  128. package/src/test-utils/factories/talkpilot/sessions.ts +35 -35
  129. package/src/utils/validation.ts +23 -23
  130. package/tsconfig.json +23 -23
@@ -1,33 +1,33 @@
1
- import { Factory } from "fishery";
2
- import { ObjectId } from "mongodb";
3
- import { faker } from "@faker-js/faker";
4
- import type { Flow } from "../../../talkpilot";
5
-
6
- export const flowFactory = Factory.define<Flow & { _id: ObjectId }>(() => {
7
- const now = new Date();
8
- return {
9
- _id: new ObjectId(),
10
- flowName: faker.lorem.words(2),
11
- clientId: faker.string.uuid(),
12
- systemInstructions: faker.lorem.sentences(2),
13
- initialSentence: faker.lorem.sentence(),
14
- insights: [],
15
- interactions: [],
16
- createdAt: now,
17
- updatedAt: now,
18
- };
19
- });
20
-
21
- export function createFlow(
22
- overrides?: Partial<Flow>,
23
- ): Flow & { _id: ObjectId } {
24
- const now = new Date();
25
- const base = flowFactory.build();
26
- return {
27
- ...base,
28
- ...overrides,
29
- _id: (overrides?._id as ObjectId) ?? base._id,
30
- updatedAt: now,
31
- createdAt: overrides?.createdAt ?? now,
32
- };
33
- }
1
+ import { Factory } from "fishery";
2
+ import { ObjectId } from "mongodb";
3
+ import { faker } from "@faker-js/faker";
4
+ import type { Flow } from "../../../talkpilot";
5
+
6
+ export const flowFactory = Factory.define<Flow & { _id: ObjectId }>(() => {
7
+ const now = new Date();
8
+ return {
9
+ _id: new ObjectId(),
10
+ flowName: faker.lorem.words(2),
11
+ clientId: faker.string.uuid(),
12
+ systemInstructions: faker.lorem.sentences(2),
13
+ initialSentence: faker.lorem.sentence(),
14
+ insights: [],
15
+ interactions: [],
16
+ createdAt: now,
17
+ updatedAt: now,
18
+ };
19
+ });
20
+
21
+ export function createFlow(
22
+ overrides?: Partial<Flow>,
23
+ ): Flow & { _id: ObjectId } {
24
+ const now = new Date();
25
+ const base = flowFactory.build();
26
+ return {
27
+ ...base,
28
+ ...overrides,
29
+ _id: (overrides?._id as ObjectId) ?? base._id,
30
+ updatedAt: now,
31
+ createdAt: overrides?.createdAt ?? now,
32
+ };
33
+ }
@@ -1,33 +1,33 @@
1
- import { Factory } from "fishery";
2
- import { ObjectId } from "mongodb";
3
- import { faker } from "@faker-js/faker";
4
- import type { Group, GroupContact, GroupDoc } from "../../../talkpilot";
5
-
6
- export const groupContactFactory = Factory.define<GroupContact>(() => ({
7
- name: faker.person.firstName(),
8
- phone: {
9
- national: "500000000",
10
- національний: "500000000",
11
- nacionales: "500000000",
12
- национальные: "500000000",
13
- e164: "+972500000000" as const,
14
- region: "IL",
15
- countryCallingCode: "972",
16
- formatted: "+972 50-000-0000",
17
- },
18
- gender: faker.helpers.arrayElement(["male", "female"]),
19
- }));
20
-
21
- export const groupFactory = Factory.define<GroupDoc>(() => ({
22
- _id: new ObjectId(),
23
- clientId: faker.string.uuid(),
24
- createdAt: new Date(),
25
- updatedAt: new Date(),
26
- name: faker.company.name(),
27
- description: faker.lorem.sentence(),
28
- contacts: groupContactFactory.buildList(2),
29
- }));
30
-
31
- export function createGroup(overrides?: Partial<Group>): GroupDoc {
32
- return groupFactory.build(overrides);
33
- }
1
+ import { Factory } from "fishery";
2
+ import { ObjectId } from "mongodb";
3
+ import { faker } from "@faker-js/faker";
4
+ import type { Group, GroupContact, GroupDoc } from "../../../talkpilot";
5
+
6
+ export const groupContactFactory = Factory.define<GroupContact>(() => ({
7
+ name: faker.person.firstName(),
8
+ phone: {
9
+ national: "500000000",
10
+ національний: "500000000",
11
+ nacionales: "500000000",
12
+ национальные: "500000000",
13
+ e164: "+972500000000" as const,
14
+ region: "IL",
15
+ countryCallingCode: "972",
16
+ formatted: "+972 50-000-0000",
17
+ },
18
+ gender: faker.helpers.arrayElement(["male", "female"]),
19
+ }));
20
+
21
+ export const groupFactory = Factory.define<GroupDoc>(() => ({
22
+ _id: new ObjectId(),
23
+ clientId: faker.string.uuid(),
24
+ createdAt: new Date(),
25
+ updatedAt: new Date(),
26
+ name: faker.company.name(),
27
+ description: faker.lorem.sentence(),
28
+ contacts: groupContactFactory.buildList(2),
29
+ }));
30
+
31
+ export function createGroup(overrides?: Partial<Group>): GroupDoc {
32
+ return groupFactory.build(overrides);
33
+ }
@@ -1,22 +1,22 @@
1
- import { Factory } from "fishery";
2
- import { ObjectId } from "mongodb";
3
- import { faker } from "@faker-js/faker";
4
- import type { PhoneNumber } from "../../../talkpilot";
5
-
6
- export const phoneNumberFactory = Factory.define<
7
- PhoneNumber & { _id?: ObjectId }
8
- >(() => ({
9
- _id: new ObjectId(),
10
- client_id: faker.string.uuid(),
11
- flow_id: new ObjectId(),
12
- phone_number: faker.phone.number(),
13
- createdAt: new Date(),
14
- updatedAt: new Date(),
15
- is_primary: true,
16
- }));
17
-
18
- export function createPhoneNumber(
19
- overrides?: Partial<PhoneNumber> & { flow_id?: ObjectId },
20
- ): PhoneNumber & { _id?: ObjectId } {
21
- return phoneNumberFactory.build(overrides);
22
- }
1
+ import { Factory } from "fishery";
2
+ import { ObjectId } from "mongodb";
3
+ import { faker } from "@faker-js/faker";
4
+ import type { PhoneNumber } from "../../../talkpilot";
5
+
6
+ export const phoneNumberFactory = Factory.define<
7
+ PhoneNumber & { _id?: ObjectId }
8
+ >(() => ({
9
+ _id: new ObjectId(),
10
+ client_id: faker.string.uuid(),
11
+ flow_id: new ObjectId(),
12
+ phone_number: faker.phone.number(),
13
+ createdAt: new Date(),
14
+ updatedAt: new Date(),
15
+ is_primary: true,
16
+ }));
17
+
18
+ export function createPhoneNumber(
19
+ overrides?: Partial<PhoneNumber> & { flow_id?: ObjectId },
20
+ ): PhoneNumber & { _id?: ObjectId } {
21
+ return phoneNumberFactory.build(overrides);
22
+ }
@@ -1,35 +1,35 @@
1
- import { Factory } from "fishery";
2
- import { ObjectId } from "mongodb";
3
- import { faker } from "@faker-js/faker";
4
- import type { Session } from "../../../talkpilot";
5
-
6
- export const sessionFactory = Factory.define<Session>(() => ({
7
- _id: new ObjectId(),
8
- session_name: faker.lorem.word(),
9
- clientId: faker.string.uuid(),
10
- flow_id: new ObjectId(),
11
- phone_numbers: [
12
- {
13
- name: faker.person.firstName(),
14
- phoneNumber: faker.phone.number(),
15
- gender: "male" as const,
16
- },
17
- ],
18
- json: null,
19
- metaKeys: null,
20
- voice: null,
21
- company_name: null,
22
- createdAt: new Date(),
23
- updatedAt: new Date(),
24
- }));
25
-
26
- export function createSession(overrides?: Partial<Session>): Session {
27
- const now = new Date();
28
- const base = sessionFactory.build();
29
- return {
30
- ...base,
31
- ...overrides,
32
- createdAt: overrides?.createdAt ?? now,
33
- updatedAt: now,
34
- };
35
- }
1
+ import { Factory } from "fishery";
2
+ import { ObjectId } from "mongodb";
3
+ import { faker } from "@faker-js/faker";
4
+ import type { Session } from "../../../talkpilot";
5
+
6
+ export const sessionFactory = Factory.define<Session>(() => ({
7
+ _id: new ObjectId(),
8
+ session_name: faker.lorem.word(),
9
+ clientId: faker.string.uuid(),
10
+ flow_id: new ObjectId(),
11
+ phone_numbers: [
12
+ {
13
+ name: faker.person.firstName(),
14
+ phoneNumber: faker.phone.number(),
15
+ gender: "male" as const,
16
+ },
17
+ ],
18
+ json: null,
19
+ metaKeys: null,
20
+ voice: null,
21
+ company_name: null,
22
+ createdAt: new Date(),
23
+ updatedAt: new Date(),
24
+ }));
25
+
26
+ export function createSession(overrides?: Partial<Session>): Session {
27
+ const now = new Date();
28
+ const base = sessionFactory.build();
29
+ return {
30
+ ...base,
31
+ ...overrides,
32
+ createdAt: overrides?.createdAt ?? now,
33
+ updatedAt: now,
34
+ };
35
+ }
@@ -1,23 +1,23 @@
1
- /**
2
- * Simple validation utilities for the core-db package.
3
- * Designed to be lightweight and only run when needed.
4
- */
5
-
6
- export const validateConfig = (configName: string, value?: string): string => {
7
- if (!value || value.trim() === "") {
8
- throw new Error(
9
- `[core-db] Configuration Error: '${configName}' is missing. ` +
10
- `Please provide it via parameters or set the corresponding environment variable.`,
11
- );
12
- }
13
- return value;
14
- };
15
-
16
- export const validateMongoUri = (uri: string): void => {
17
- if (!uri.startsWith("mongodb://") && !uri.startsWith("mongodb+srv://")) {
18
- throw new Error(
19
- `[core-db] Connection Error: The provided MongoDB URI is invalid. ` +
20
- `It must start with 'mongodb://' or 'mongodb+srv://'. Received: '${uri}'`,
21
- );
22
- }
23
- };
1
+ /**
2
+ * Simple validation utilities for the core-db package.
3
+ * Designed to be lightweight and only run when needed.
4
+ */
5
+
6
+ export const validateConfig = (configName: string, value?: string): string => {
7
+ if (!value || value.trim() === "") {
8
+ throw new Error(
9
+ `[core-db] Configuration Error: '${configName}' is missing. ` +
10
+ `Please provide it via parameters or set the corresponding environment variable.`,
11
+ );
12
+ }
13
+ return value;
14
+ };
15
+
16
+ export const validateMongoUri = (uri: string): void => {
17
+ if (!uri.startsWith("mongodb://") && !uri.startsWith("mongodb+srv://")) {
18
+ throw new Error(
19
+ `[core-db] Connection Error: The provided MongoDB URI is invalid. ` +
20
+ `It must start with 'mongodb://' or 'mongodb+srv://'. Received: '${uri}'`,
21
+ );
22
+ }
23
+ };
package/tsconfig.json CHANGED
@@ -1,23 +1,23 @@
1
- {
2
- "compilerOptions": {
3
- "target": "ES2022",
4
- "module": "CommonJS",
5
- "moduleResolution": "node",
6
- "lib": ["ES2022"],
7
- "declaration": true,
8
- "declarationMap": true,
9
- "sourceMap": true,
10
- "outDir": "dist",
11
- "rootDir": "src",
12
- "strict": true,
13
- "esModuleInterop": true,
14
- "forceConsistentCasingInFileNames": true,
15
- "skipLibCheck": true,
16
- "resolveJsonModule": true,
17
- "experimentalDecorators": true,
18
- "emitDecoratorMetadata": true,
19
- "baseUrl": "."
20
- },
21
- "include": ["src/**/*"],
22
- "exclude": ["node_modules", "dist", "test", "**/*.test.ts", "**/__tests__/*", "**/*.spec.ts"]
23
- }
1
+ {
2
+ "compilerOptions": {
3
+ "target": "ES2022",
4
+ "module": "CommonJS",
5
+ "moduleResolution": "node",
6
+ "lib": ["ES2022"],
7
+ "declaration": true,
8
+ "declarationMap": true,
9
+ "sourceMap": true,
10
+ "outDir": "dist",
11
+ "rootDir": "src",
12
+ "strict": true,
13
+ "esModuleInterop": true,
14
+ "forceConsistentCasingInFileNames": true,
15
+ "skipLibCheck": true,
16
+ "resolveJsonModule": true,
17
+ "experimentalDecorators": true,
18
+ "emitDecoratorMetadata": true,
19
+ "baseUrl": "."
20
+ },
21
+ "include": ["src/**/*"],
22
+ "exclude": ["node_modules", "dist", "test", "**/*.test.ts", "**/__tests__/*", "**/*.spec.ts"]
23
+ }