@talkpilot/core-db 1.2.0 → 1.2.1

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 (132) 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 +1 -2
  5. package/dist/talkpilot/calls/calls.getters.d.ts.map +1 -1
  6. package/dist/talkpilot/calls/calls.getters.js +0 -176
  7. package/dist/talkpilot/calls/calls.getters.js.map +1 -1
  8. package/dist/talkpilot/calls/calls.types.d.ts +0 -48
  9. package/dist/talkpilot/calls/calls.types.d.ts.map +1 -1
  10. package/dist/talkpilot/clientsConfig/clientsConfig.getters.d.ts +0 -1
  11. package/dist/talkpilot/clientsConfig/clientsConfig.getters.d.ts.map +1 -1
  12. package/dist/talkpilot/clientsConfig/clientsConfig.getters.js +0 -13
  13. package/dist/talkpilot/clientsConfig/clientsConfig.getters.js.map +1 -1
  14. package/dist/talkpilot/clientsConfig/clientsConfig.types.d.ts +16 -8
  15. package/dist/talkpilot/clientsConfig/clientsConfig.types.d.ts.map +1 -1
  16. package/jest.config.js +19 -19
  17. package/package.json +45 -45
  18. package/src/__tests__/setup.ts +20 -20
  19. package/src/connection.ts +42 -42
  20. package/src/index.ts +16 -16
  21. package/src/municipal/__tests__/validation.spec.ts +62 -62
  22. package/src/municipal/cities/cities.getters.ts +50 -50
  23. package/src/municipal/cities/cities.types.ts +11 -11
  24. package/src/municipal/cities/index.ts +2 -2
  25. package/src/municipal/departmentsSubjects/departmentsSubjects.getters.ts +282 -282
  26. package/src/municipal/departmentsSubjects/departmentsSubjects.types.ts +72 -72
  27. package/src/municipal/departmentsSubjects/index.ts +9 -9
  28. package/src/municipal/index.ts +21 -21
  29. package/src/municipal/mongodb-client.ts +61 -61
  30. package/src/municipal/streets/index.ts +2 -2
  31. package/src/municipal/streets/streets.getters.ts +125 -125
  32. package/src/municipal/streets/streets.types.ts +18 -18
  33. package/src/municipal/systemInstructions/__tests__/getters.spec.ts +113 -113
  34. package/src/municipal/systemInstructions/__tests__/setters.spec.ts +274 -274
  35. package/src/municipal/systemInstructions/index.ts +7 -7
  36. package/src/municipal/systemInstructions/instructions.getters.ts +57 -57
  37. package/src/municipal/systemInstructions/instructions.setters.ts +119 -119
  38. package/src/municipal/systemInstructions/instructions.types.ts +30 -30
  39. package/src/municipal/tickets/__tests__/tickets.getters.spec.ts +66 -66
  40. package/src/municipal/tickets/index.ts +2 -2
  41. package/src/municipal/tickets/tickets.getters.ts +261 -261
  42. package/src/municipal/tickets/tickets.types.ts +43 -43
  43. package/src/municipal/utils/types.ts +11 -11
  44. package/src/talkpilot/__tests__/db.spec.ts +38 -38
  45. package/src/talkpilot/__tests__/mongodb-client.spec.ts +18 -18
  46. package/src/talkpilot/__tests__/validation.spec.ts +68 -68
  47. package/src/talkpilot/agents/__tests__/agents.getters.spec.ts +29 -29
  48. package/src/talkpilot/agents/agents.getters.ts +34 -34
  49. package/src/talkpilot/agents/agents.types.ts +14 -14
  50. package/src/talkpilot/agents/index.ts +2 -2
  51. package/src/talkpilot/backgroundToolResults/__tests__/backgroundToolResults.getters.spec.ts +147 -147
  52. package/src/talkpilot/backgroundToolResults/backgroundToolResults.getters.ts +65 -65
  53. package/src/talkpilot/backgroundToolResults/backgroundToolResults.types.ts +23 -23
  54. package/src/talkpilot/backgroundToolResults/index.ts +2 -2
  55. package/src/talkpilot/calls/__tests__/callStats.utils.spec.ts +128 -128
  56. package/src/talkpilot/calls/__tests__/calls.spec.ts +252 -252
  57. package/src/talkpilot/calls/calls.getters.ts +248 -446
  58. package/src/talkpilot/calls/calls.types.ts +115 -171
  59. package/src/talkpilot/calls/index.ts +2 -2
  60. package/src/talkpilot/clientAudioBuffers/__tests__/clientAudioBuffer.getters.spec.ts +160 -160
  61. package/src/talkpilot/clientAudioBuffers/clientAudioBuffer.getters.ts +117 -117
  62. package/src/talkpilot/clientAudioBuffers/clientsAudioBuffers.types.ts +25 -25
  63. package/src/talkpilot/clientAudioBuffers/index.ts +2 -2
  64. package/src/talkpilot/clients/clients.getters.ts +16 -16
  65. package/src/talkpilot/clients/clients.types.ts +14 -14
  66. package/src/talkpilot/clients/index.ts +2 -2
  67. package/src/talkpilot/clientsConfig/__tests__/clientsConfig.spec.ts +187 -106
  68. package/src/talkpilot/clientsConfig/clientsConfig.getters.ts +22 -44
  69. package/src/talkpilot/clientsConfig/clientsConfig.types.ts +119 -94
  70. package/src/talkpilot/clientsConfig/index.ts +2 -2
  71. package/src/talkpilot/flows/__tests__/flows.schema.spec.ts +67 -67
  72. package/src/talkpilot/flows/flows.getter.ts +14 -14
  73. package/src/talkpilot/flows/flows.schema.ts +153 -153
  74. package/src/talkpilot/flows/flows.types.ts +184 -184
  75. package/src/talkpilot/flows/index.ts +2 -2
  76. package/src/talkpilot/groups/__tests__/groups.spec.ts +90 -90
  77. package/src/talkpilot/groups/__tests__/phone.utils.spec.ts +32 -32
  78. package/src/talkpilot/groups/groups.getters.ts +30 -30
  79. package/src/talkpilot/groups/groups.types.ts +29 -29
  80. package/src/talkpilot/groups/index.ts +3 -3
  81. package/src/talkpilot/groups/phone.utils.ts +46 -46
  82. package/src/talkpilot/index.ts +29 -29
  83. package/src/talkpilot/leads/index.ts +2 -2
  84. package/src/talkpilot/leads/leads.getter.ts +6 -6
  85. package/src/talkpilot/leads/leads.schema.ts +33 -33
  86. package/src/talkpilot/leads/leads.types.ts +20 -20
  87. package/src/talkpilot/mongodb-client.ts +78 -78
  88. package/src/talkpilot/phone_numbers/__tests__/phone_numbers.spec.ts +247 -247
  89. package/src/talkpilot/phone_numbers/index.ts +2 -2
  90. package/src/talkpilot/phone_numbers/phone_numbers.getter.ts +154 -154
  91. package/src/talkpilot/phone_numbers/phone_numbers.schema.ts +17 -17
  92. package/src/talkpilot/phone_numbers/phone_numbers.types.ts +30 -30
  93. package/src/talkpilot/plans/__tests__/plans.spec.ts +70 -70
  94. package/src/talkpilot/plans/index.ts +2 -2
  95. package/src/talkpilot/plans/plans.getters.ts +132 -132
  96. package/src/talkpilot/plans/plans.types.ts +89 -89
  97. package/src/talkpilot/results/index.ts +7 -7
  98. package/src/talkpilot/results/results.getter.ts +35 -35
  99. package/src/talkpilot/results/results.schema.ts +25 -25
  100. package/src/talkpilot/results/results.types.ts +34 -34
  101. package/src/talkpilot/retry_analyze/__tests__/retryAnalyze.getters.spec.ts +156 -156
  102. package/src/talkpilot/retry_analyze/index.ts +2 -2
  103. package/src/talkpilot/retry_analyze/retryAnalyze.getters.ts +75 -75
  104. package/src/talkpilot/retry_analyze/retryAnalyze.types.ts +13 -13
  105. package/src/talkpilot/sessions/__tests__/sessions.spec.ts +147 -147
  106. package/src/talkpilot/sessions/index.ts +2 -2
  107. package/src/talkpilot/sessions/sessions.getter.ts +92 -92
  108. package/src/talkpilot/sessions/sessions.schema.ts +34 -34
  109. package/src/talkpilot/sessions/sessions.types.ts +30 -30
  110. package/src/talkpilot/subscriptions/__tests__/subscriptions.getters.utils.spec.ts +45 -45
  111. package/src/talkpilot/subscriptions/index.ts +3 -3
  112. package/src/talkpilot/subscriptions/subscriptions.getters.ts +146 -146
  113. package/src/talkpilot/subscriptions/subscriptions.getters.utils.ts +33 -33
  114. package/src/talkpilot/subscriptions/subscriptions.types.ts +66 -66
  115. package/src/talkpilot/utils/__tests__/query.utils.spec.ts +49 -49
  116. package/src/talkpilot/utils/query.utils.ts +21 -21
  117. package/src/test-utils/db-utils.ts +24 -24
  118. package/src/test-utils/factories/index.ts +12 -12
  119. package/src/test-utils/factories/municipal/cities.ts +16 -16
  120. package/src/test-utils/factories/municipal/departmentsSubjects.ts +37 -37
  121. package/src/test-utils/factories/municipal/streets.ts +22 -22
  122. package/src/test-utils/factories/municipal/tickets.ts +39 -39
  123. package/src/test-utils/factories/talkpilot/agents.ts +19 -19
  124. package/src/test-utils/factories/talkpilot/calls.ts +37 -37
  125. package/src/test-utils/factories/talkpilot/clientAudioBuffers.ts +20 -20
  126. package/src/test-utils/factories/talkpilot/clientsConfig.ts +18 -18
  127. package/src/test-utils/factories/talkpilot/flows.ts +33 -33
  128. package/src/test-utils/factories/talkpilot/groups.ts +33 -33
  129. package/src/test-utils/factories/talkpilot/phone_numbers.ts +22 -22
  130. package/src/test-utils/factories/talkpilot/sessions.ts +35 -35
  131. package/src/utils/validation.ts +23 -23
  132. package/tsconfig.json +23 -23
package/src/connection.ts CHANGED
@@ -1,42 +1,42 @@
1
- import { mongodbClient } from "./talkpilot";
2
- import { municipalDataMongodbClient } from "./municipal";
3
-
4
- let isConnected = false;
5
-
6
- /**
7
- * Ensures the database clients are initialized.
8
- * This function reads from MONGO_URI.
9
- */
10
- export async function ensureDbConnected() {
11
- if (isConnected) {
12
- return;
13
- }
14
-
15
- const mongoUri = process.env.MONGO_URI || process.env.MONGODB_URI;
16
- const talkpilotUri = mongoUri;
17
- const municipalUri = mongoUri;
18
-
19
- if (!talkpilotUri) {
20
- console.warn("[core-db] MONGO_URI is not set");
21
- } else {
22
- const dbNameFromUri = talkpilotUri.split("/").pop()?.split("?")[0];
23
- const dbName = dbNameFromUri || process.env.TALKPILOT_DB_NAME;
24
- await mongodbClient.connect(talkpilotUri, dbName);
25
- console.info(
26
- `[core-db] Connected to TalkPilot MongoDB: ${dbName || "via env"}`,
27
- );
28
- }
29
-
30
- if (!municipalUri) {
31
- console.warn("[core-db] MONGO_URI is not set");
32
- } else {
33
- const dbNameFromUri = municipalUri.split("/").pop()?.split("?")[0];
34
- const dbName = dbNameFromUri || process.env.MUNICIPAL_DB_NAME;
35
- await municipalDataMongodbClient.connect(municipalUri, dbName);
36
- console.info(
37
- `[core-db] Connected to Municipal Data MongoDB: ${dbName || "via env"}`,
38
- );
39
- }
40
-
41
- isConnected = true;
42
- }
1
+ import { mongodbClient } from "./talkpilot";
2
+ import { municipalDataMongodbClient } from "./municipal";
3
+
4
+ let isConnected = false;
5
+
6
+ /**
7
+ * Ensures the database clients are initialized.
8
+ * This function reads from MONGO_URI.
9
+ */
10
+ export async function ensureDbConnected() {
11
+ if (isConnected) {
12
+ return;
13
+ }
14
+
15
+ const mongoUri = process.env.MONGO_URI || process.env.MONGODB_URI;
16
+ const talkpilotUri = mongoUri;
17
+ const municipalUri = mongoUri;
18
+
19
+ if (!talkpilotUri) {
20
+ console.warn("[core-db] MONGO_URI is not set");
21
+ } else {
22
+ const dbNameFromUri = talkpilotUri.split("/").pop()?.split("?")[0];
23
+ const dbName = dbNameFromUri || process.env.TALKPILOT_DB_NAME;
24
+ await mongodbClient.connect(talkpilotUri, dbName);
25
+ console.info(
26
+ `[core-db] Connected to TalkPilot MongoDB: ${dbName || "via env"}`,
27
+ );
28
+ }
29
+
30
+ if (!municipalUri) {
31
+ console.warn("[core-db] MONGO_URI is not set");
32
+ } else {
33
+ const dbNameFromUri = municipalUri.split("/").pop()?.split("?")[0];
34
+ const dbName = dbNameFromUri || process.env.MUNICIPAL_DB_NAME;
35
+ await municipalDataMongodbClient.connect(municipalUri, dbName);
36
+ console.info(
37
+ `[core-db] Connected to Municipal Data MongoDB: ${dbName || "via env"}`,
38
+ );
39
+ }
40
+
41
+ isConnected = true;
42
+ }
package/src/index.ts CHANGED
@@ -1,16 +1,16 @@
1
- // TalkPilot DB exports
2
- export * from "./talkpilot";
3
- export * from "./connection";
4
-
5
- export {
6
- municipalDataMongodbClient,
7
- getDb as getMunicipalDataDb,
8
- setDb as setMunicipalDataDb,
9
- ObjectId as MunicipalDataObjectId,
10
- } from "./municipal";
11
- export * from "./municipal/cities";
12
- export * from "./municipal/streets";
13
- export * from "./municipal/departmentsSubjects";
14
- export * from "./municipal/tickets";
15
- export * from "./municipal/systemInstructions";
16
- export * from "./municipal/utils/types";
1
+ // TalkPilot DB exports
2
+ export * from "./talkpilot";
3
+ export * from "./connection";
4
+
5
+ export {
6
+ municipalDataMongodbClient,
7
+ getDb as getMunicipalDataDb,
8
+ setDb as setMunicipalDataDb,
9
+ ObjectId as MunicipalDataObjectId,
10
+ } from "./municipal";
11
+ export * from "./municipal/cities";
12
+ export * from "./municipal/streets";
13
+ export * from "./municipal/departmentsSubjects";
14
+ export * from "./municipal/tickets";
15
+ export * from "./municipal/systemInstructions";
16
+ export * from "./municipal/utils/types";
@@ -1,62 +1,62 @@
1
- import { municipalDataMongodbClient } from "../mongodb-client";
2
- import { MongoClient } from "mongodb";
3
-
4
- describe("MunicipalDataMongoDBClient Validation", () => {
5
- const originalEnv = process.env;
6
-
7
- beforeEach(() => {
8
- process.env = { ...originalEnv };
9
- delete process.env.MONGO_URI;
10
- delete process.env.MONGODB_URI;
11
-
12
- // Force reset singleton state
13
- (municipalDataMongodbClient as any).client = null;
14
- (municipalDataMongodbClient as any).db = null;
15
- });
16
-
17
- afterAll(async () => {
18
- process.env = originalEnv;
19
- await municipalDataMongodbClient.disconnect();
20
- });
21
-
22
- it("should succeed with default database name if only URI is provided", async () => {
23
- const mockDb = { databaseName: "municipal-data" };
24
- const connectSpy = jest
25
- .spyOn(MongoClient.prototype, "connect")
26
- .mockResolvedValue({} as any);
27
- const dbSpy = jest
28
- .spyOn(MongoClient.prototype, "db")
29
- .mockReturnValue(mockDb as any);
30
-
31
- const validUri = "mongodb://127.0.0.1:27017";
32
- await municipalDataMongodbClient.connect(validUri);
33
-
34
- expect(municipalDataMongodbClient.getDb()).toBeDefined();
35
- expect(municipalDataMongodbClient.getDb().databaseName).toBe(
36
- "municipal-data",
37
- );
38
-
39
- connectSpy.mockRestore();
40
- dbSpy.mockRestore();
41
- });
42
-
43
- it("should allow overriding the default database name", async () => {
44
- const mockDb = { databaseName: "custom-municipal-db" };
45
- const connectSpy = jest
46
- .spyOn(MongoClient.prototype, "connect")
47
- .mockResolvedValue({} as any);
48
- const dbSpy = jest
49
- .spyOn(MongoClient.prototype, "db")
50
- .mockReturnValue(mockDb as any);
51
-
52
- const validUri = "mongodb://127.0.0.1:27017";
53
- await municipalDataMongodbClient.connect(validUri, "custom-municipal-db");
54
-
55
- expect(municipalDataMongodbClient.getDb().databaseName).toBe(
56
- "custom-municipal-db",
57
- );
58
-
59
- connectSpy.mockRestore();
60
- dbSpy.mockRestore();
61
- });
62
- });
1
+ import { municipalDataMongodbClient } from "../mongodb-client";
2
+ import { MongoClient } from "mongodb";
3
+
4
+ describe("MunicipalDataMongoDBClient Validation", () => {
5
+ const originalEnv = process.env;
6
+
7
+ beforeEach(() => {
8
+ process.env = { ...originalEnv };
9
+ delete process.env.MONGO_URI;
10
+ delete process.env.MONGODB_URI;
11
+
12
+ // Force reset singleton state
13
+ (municipalDataMongodbClient as any).client = null;
14
+ (municipalDataMongodbClient as any).db = null;
15
+ });
16
+
17
+ afterAll(async () => {
18
+ process.env = originalEnv;
19
+ await municipalDataMongodbClient.disconnect();
20
+ });
21
+
22
+ it("should succeed with default database name if only URI is provided", async () => {
23
+ const mockDb = { databaseName: "municipal-data" };
24
+ const connectSpy = jest
25
+ .spyOn(MongoClient.prototype, "connect")
26
+ .mockResolvedValue({} as any);
27
+ const dbSpy = jest
28
+ .spyOn(MongoClient.prototype, "db")
29
+ .mockReturnValue(mockDb as any);
30
+
31
+ const validUri = "mongodb://127.0.0.1:27017";
32
+ await municipalDataMongodbClient.connect(validUri);
33
+
34
+ expect(municipalDataMongodbClient.getDb()).toBeDefined();
35
+ expect(municipalDataMongodbClient.getDb().databaseName).toBe(
36
+ "municipal-data",
37
+ );
38
+
39
+ connectSpy.mockRestore();
40
+ dbSpy.mockRestore();
41
+ });
42
+
43
+ it("should allow overriding the default database name", async () => {
44
+ const mockDb = { databaseName: "custom-municipal-db" };
45
+ const connectSpy = jest
46
+ .spyOn(MongoClient.prototype, "connect")
47
+ .mockResolvedValue({} as any);
48
+ const dbSpy = jest
49
+ .spyOn(MongoClient.prototype, "db")
50
+ .mockReturnValue(mockDb as any);
51
+
52
+ const validUri = "mongodb://127.0.0.1:27017";
53
+ await municipalDataMongodbClient.connect(validUri, "custom-municipal-db");
54
+
55
+ expect(municipalDataMongodbClient.getDb().databaseName).toBe(
56
+ "custom-municipal-db",
57
+ );
58
+
59
+ connectSpy.mockRestore();
60
+ dbSpy.mockRestore();
61
+ });
62
+ });
@@ -1,50 +1,50 @@
1
- import { getDb, ObjectId, City } from "../index";
2
- import { Collection, Filter, ObjectId as MongoObjectId } from "mongodb";
3
-
4
- export const getCitiesCollection = (): Collection<City> => {
5
- return getDb().collection<City>("cities");
6
- };
7
-
8
- export const findCities = async (
9
- filter: Filter<City> = {},
10
- ): Promise<City[]> => {
11
- return await getCitiesCollection().find(filter).toArray();
12
- };
13
-
14
- export const getCityById = async (cityId: string): Promise<City | null> => {
15
- const city = await getCitiesCollection().findOne({
16
- _id: new ObjectId(cityId),
17
- });
18
- return city ? city : null;
19
- };
20
-
21
- export const createCity = async (
22
- cityData: Omit<City, "_id" | "createdAt" | "updatedAt">,
23
- ): Promise<MongoObjectId> => {
24
- const city: Omit<City, "_id"> = {
25
- ...cityData,
26
- createdAt: new Date(),
27
- updatedAt: new Date(),
28
- };
29
- const { insertedId } = await getCitiesCollection().insertOne(city as City);
30
- return insertedId;
31
- };
32
-
33
- export const updateCity = async (
34
- cityId: string,
35
- data: Partial<Omit<City, "_id" | "createdAt" | "updatedAt">>,
36
- ): Promise<City | null> => {
37
- const result = await getCitiesCollection().findOneAndUpdate(
38
- { _id: new ObjectId(cityId) },
39
- { $set: { ...data, updatedAt: new Date() } },
40
- { returnDocument: "after" },
41
- );
42
- return result || null;
43
- };
44
-
45
- export const deleteCity = async (cityId: string): Promise<boolean> => {
46
- const result = await getCitiesCollection().deleteOne({
47
- _id: new ObjectId(cityId),
48
- });
49
- return result.deletedCount > 0;
50
- };
1
+ import { getDb, ObjectId, City } from "../index";
2
+ import { Collection, Filter, ObjectId as MongoObjectId } from "mongodb";
3
+
4
+ export const getCitiesCollection = (): Collection<City> => {
5
+ return getDb().collection<City>("cities");
6
+ };
7
+
8
+ export const findCities = async (
9
+ filter: Filter<City> = {},
10
+ ): Promise<City[]> => {
11
+ return await getCitiesCollection().find(filter).toArray();
12
+ };
13
+
14
+ export const getCityById = async (cityId: string): Promise<City | null> => {
15
+ const city = await getCitiesCollection().findOne({
16
+ _id: new ObjectId(cityId),
17
+ });
18
+ return city ? city : null;
19
+ };
20
+
21
+ export const createCity = async (
22
+ cityData: Omit<City, "_id" | "createdAt" | "updatedAt">,
23
+ ): Promise<MongoObjectId> => {
24
+ const city: Omit<City, "_id"> = {
25
+ ...cityData,
26
+ createdAt: new Date(),
27
+ updatedAt: new Date(),
28
+ };
29
+ const { insertedId } = await getCitiesCollection().insertOne(city as City);
30
+ return insertedId;
31
+ };
32
+
33
+ export const updateCity = async (
34
+ cityId: string,
35
+ data: Partial<Omit<City, "_id" | "createdAt" | "updatedAt">>,
36
+ ): Promise<City | null> => {
37
+ const result = await getCitiesCollection().findOneAndUpdate(
38
+ { _id: new ObjectId(cityId) },
39
+ { $set: { ...data, updatedAt: new Date() } },
40
+ { returnDocument: "after" },
41
+ );
42
+ return result || null;
43
+ };
44
+
45
+ export const deleteCity = async (cityId: string): Promise<boolean> => {
46
+ const result = await getCitiesCollection().deleteOne({
47
+ _id: new ObjectId(cityId),
48
+ });
49
+ return result.deletedCount > 0;
50
+ };
@@ -1,11 +1,11 @@
1
- import { ObjectId, WithId } from "mongodb";
2
-
3
- export type City = {
4
- _id: ObjectId;
5
- createdAt: Date;
6
- updatedAt: Date;
7
- name: string;
8
- displayName: string;
9
- };
10
-
11
- export type CityDoc = WithId<City>;
1
+ import { ObjectId, WithId } from "mongodb";
2
+
3
+ export type City = {
4
+ _id: ObjectId;
5
+ createdAt: Date;
6
+ updatedAt: Date;
7
+ name: string;
8
+ displayName: string;
9
+ };
10
+
11
+ export type CityDoc = WithId<City>;
@@ -1,2 +1,2 @@
1
- export * from "./cities.getters";
2
- export type { City, CityDoc } from "./cities.types";
1
+ export * from "./cities.getters";
2
+ export type { City, CityDoc } from "./cities.types";