@talkpilot/core-db 1.3.11 → 1.3.13

package/src/talkpilot/contextNotes/__tests__/contextNotes.getters.spec.ts

@@ -32,7 +32,9 @@ describe("contextNotes getters", () => {
 
   it("should return documents matching clientId and product", async () => {
     const clientId = new ObjectId().toString();
-    await createContextNote(buildContextNote({ clientId, product: "Municipal" }));
+    await createContextNote(
+      buildContextNote({ clientId, product: "Municipal" }),
+    );
     await createContextNote(buildContextNote({ clientId, product: "Clinics" }));
     await createContextNote(buildContextNote({ product: "Municipal" })); // different client
 
@@ -44,7 +46,9 @@ describe("contextNotes getters", () => {
 
   it("should not return documents for a different product", async () => {
     const clientId = new ObjectId().toString();
-    await createContextNote(buildContextNote({ clientId, product: "Municipal" }));
+    await createContextNote(
+      buildContextNote({ clientId, product: "Municipal" }),
+    );
     await createContextNote(buildContextNote({ clientId, product: "Clinics" }));
 
     const results = await getContextNotes(clientId, "Rcure");
@@ -57,26 +61,45 @@ describe("contextNotes getters", () => {
     const past = new Date(now.getTime() - 10000);
     const future = new Date(now.getTime() + 10000);
 
-    const activeNote = createContextNoteEntry({ activeFrom: past, expiresAt: future });
-    const expiredNote = createContextNoteEntry({ activeFrom: past, expiresAt: past });
-    const notYetActiveNote = createContextNoteEntry({ activeFrom: future, expiresAt: null });
-    const noExpiryNote = createContextNoteEntry({ activeFrom: past, expiresAt: null });
+    const activeNote = createContextNoteEntry({
+      activeFrom: past,
+      expiresAt: future,
+    });
+    const expiredNote = createContextNoteEntry({
+      activeFrom: past,
+      expiresAt: past,
+    });
+    const notYetActiveNote = createContextNoteEntry({
+      activeFrom: future,
+      expiresAt: null,
+    });
+    const noExpiryNote = createContextNoteEntry({
+      activeFrom: past,
+      expiresAt: null,
+    });
 
-    await createContextNote(buildContextNote({
-      clientId,
-      product: "Municipal",
-      notes: [activeNote, expiredNote, notYetActiveNote, noExpiryNote],
-    }));
+    await createContextNote(
+      buildContextNote({
+        clientId,
+        product: "Municipal",
+        notes: [activeNote, expiredNote, notYetActiveNote, noExpiryNote],
+      }),
+    );
 
     const results = await getActiveContextNotes(clientId, "Municipal");
     expect(results).toHaveLength(2);
     expect(results.map((n) => n._id.toString())).toEqual(
-      expect.arrayContaining([activeNote._id.toString(), noExpiryNote._id.toString()]),
+      expect.arrayContaining([
+        activeNote._id.toString(),
+        noExpiryNote._id.toString(),
+      ]),
     );
   });
 
   it("should replace the notes array on a document", async () => {
-    const doc = buildContextNote({ notes: [createContextNoteEntry(), createContextNoteEntry()] });
+    const doc = buildContextNote({
+      notes: [createContextNoteEntry(), createContextNoteEntry()],
+    });
     const id = await createContextNote(doc);
 
     const newNotes = [createContextNoteEntry({ title: "updated" })];
@@ -94,11 +117,15 @@ describe("contextNotes getters", () => {
   });
 
   it("should store and retrieve a systemPrompt set at creation", async () => {
-    const doc = buildContextNote({ systemPrompt: "Treat this information as highly reliable." });
+    const doc = buildContextNote({
+      systemPrompt: "Treat this information as highly reliable.",
+    });
     const id = await createContextNote(doc);
 
     const saved = await getContextNotesCollection().findOne({ _id: id });
-    expect(saved?.systemPrompt).toBe("Treat this information as highly reliable.");
+    expect(saved?.systemPrompt).toBe(
+      "Treat this information as highly reliable.",
+    );
   });
 
   it("should not touch systemPrompt or product when setContextNoteEntries is called", async () => {
@@ -121,7 +148,9 @@ describe("contextNotes getters", () => {
     const doc = buildContextNote({ notes: [] });
     const id = await createContextNote(doc);
 
-    const updated = await setContextNoteConfig(id, doc.clientId, { systemPrompt: "New instructions." });
+    const updated = await setContextNoteConfig(id, doc.clientId, {
+      systemPrompt: "New instructions.",
+    });
     expect(updated).toBe(true);
 
     const saved = await getContextNotesCollection().findOne({ _id: id });
@@ -132,7 +161,9 @@ describe("contextNotes getters", () => {
     const doc = buildContextNote({ product: "Municipal" });
     const id = await createContextNote(doc);
 
-    const updated = await setContextNoteConfig(id, doc.clientId, { product: "Clinics" });
+    const updated = await setContextNoteConfig(id, doc.clientId, {
+      product: "Clinics",
+    });
     expect(updated).toBe(true);
 
     const saved = await getContextNotesCollection().findOne({ _id: id });
@@ -148,7 +179,9 @@ describe("contextNotes getters", () => {
   });
 
   it("should return false from setContextNoteConfig for a non-existent document", async () => {
-    const result = await setContextNoteConfig(new ObjectId(), "nobody", { systemPrompt: "x" });
+    const result = await setContextNoteConfig(new ObjectId(), "nobody", {
+      systemPrompt: "x",
+    });
     expect(result).toBe(false);
   });
 
@@ -158,7 +191,11 @@ describe("contextNotes getters", () => {
     const doc = buildContextNote({ notes: [noteToKeep, noteToDelete] });
     const id = await createContextNote(doc);
 
-    const deleted = await deleteContextNoteEntry(id, doc.clientId, noteToDelete._id);
+    const deleted = await deleteContextNoteEntry(
+      id,
+      doc.clientId,
+      noteToDelete._id,
+    );
     expect(deleted).toBe(true);
 
     const saved = await getContextNotesCollection().findOne({ _id: id });
@@ -170,7 +207,11 @@ describe("contextNotes getters", () => {
     const doc = buildContextNote({ notes: [] });
     const id = await createContextNote(doc);
 
-    const result = await deleteContextNoteEntry(id, doc.clientId, new ObjectId());
+    const result = await deleteContextNoteEntry(
+      id,
+      doc.clientId,
+      new ObjectId(),
+    );
     expect(result).toBe(false);
   });
 });

package/src/talkpilot/contextNotes/contextNotes.getters.ts

@@ -11,9 +11,7 @@ export const getContextNotes = (
   clientId: string,
   product: string,
 ): Promise<WithId<ContextNote>[]> => {
-  return getContextNotesCollection()
-    .find({ clientId, product })
-    .toArray();
+  return getContextNotesCollection().find({ clientId, product }).toArray();
 };
 
 /** Returns all currently active note entries across matching documents */
@@ -61,7 +59,8 @@ export const setContextNoteConfig = async (
   config: { systemPrompt?: string; product?: string },
 ): Promise<boolean> => {
   const fields: Partial<ContextNote> = {};
-  if (config.systemPrompt !== undefined) fields.systemPrompt = config.systemPrompt;
+  if (config.systemPrompt !== undefined)
+    fields.systemPrompt = config.systemPrompt;
   if (config.product !== undefined) fields.product = config.product;
   if (!Object.keys(fields).length) return false;
 

package/src/talkpilot/flows/flows.schema.ts

@@ -43,6 +43,7 @@ export const flowMongoSchema = {
       },
       additionalProperties: false,
     },
+    useRedisTranscription: { bsonType: "bool" },
     interactions: {
       bsonType: "array",
       items: {

package/src/talkpilot/flows/flows.types.ts

@@ -167,6 +167,8 @@ export type Flow = {
 
   insights: string[];
   conversationSettings?: ConversationSettings;
+  /** When true, prefer cached transcription from Redis (default: false). */
+  useRedisTranscription?: boolean;
 
   interactions: Interaction[];
 

package/src/talkpilot/products/__tests__/products.getters.spec.ts

@@ -41,5 +41,4 @@ describe("products getters", () => {
     const saved = results.find((p) => p._id.equals(id));
     expect(saved?.displayName).toBeUndefined();
   });
-
 });

package/src/test-utils/factories/talkpilot/contextNotes.ts

@@ -13,7 +13,9 @@ export const contextNoteEntryFactory = Factory.define<ContextNoteEntry>(() => ({
   updatedAt: new Date(),
 }));
 
-export const contextNoteFactory = Factory.define<ContextNote & { _id: ObjectId }>(() => ({
+export const contextNoteFactory = Factory.define<
+  ContextNote & { _id: ObjectId }
+>(() => ({
   _id: new ObjectId(),
   clientId: faker.string.uuid(),
   product: "Municipal",
@@ -23,11 +25,16 @@ export const contextNoteFactory = Factory.define<ContextNote & { _id: ObjectId }
 export function createContextNoteEntry(
   overrides?: Partial<ContextNoteEntry>,
 ): ContextNoteEntry {
-  return { ...contextNoteEntryFactory.build(), ...overrides } as ContextNoteEntry;
+  return {
+    ...contextNoteEntryFactory.build(),
+    ...overrides,
+  } as ContextNoteEntry;
 }
 
 export function createContextNote(
   overrides?: Partial<ContextNote>,
 ): ContextNote & { _id: ObjectId } {
-  return { ...contextNoteFactory.build(), ...overrides } as ContextNote & { _id: ObjectId };
+  return { ...contextNoteFactory.build(), ...overrides } as ContextNote & {
+    _id: ObjectId;
+  };
 }

package/src/test-utils/factories/talkpilot/flows.ts

@@ -13,6 +13,7 @@ export const flowFactory = Factory.define<Flow & { _id: ObjectId }>(() => {
     initialSentence: faker.lorem.sentence(),
     insights: [],
     interactions: [],
+    useRedisTranscription: false,
     createdAt: now,
     updatedAt: now,
   };

package/src/utils/date.utils.ts

@@ -31,7 +31,8 @@ export const toUtcDate = (dateStr: string): Date =>
   new Date(`${dateStr}T00:00:00.000Z`);
 
 /** Formats a date as a `YYYY-MM-DD` string in UTC. */
-export const formatDate = (date: Date): string => date.toISOString().slice(0, 10);
+export const formatDate = (date: Date): string =>
+  date.toISOString().slice(0, 10);
 
 /** Adds `days` to a `YYYY-MM-DD` string, returning the resulting `YYYY-MM-DD`. */
 export const addDaysToDateStr = (dateStr: string, days: number): string =>
@@ -76,9 +77,10 @@ export const getYmdInTz = (date: Date, timezone: string) => {
 /** Weekday index (Sun = 0) of a date in the given timezone. */
 export const getWeekdayInTz = (date: Date, timezone: string): number =>
   WEEKDAY[
-    new Intl.DateTimeFormat("en-US", { timeZone: timezone, weekday: "short" }).format(
-      date,
-    )
+    new Intl.DateTimeFormat("en-US", {
+      timeZone: timezone,
+      weekday: "short",
+    }).format(date)
   ] ?? 0;
 
 /**
@@ -94,7 +96,10 @@ export const dateAtNoonUtc = (dateStr: string): Date => {
  * UTC instant at the start of the given `YYYY-MM-DD` calendar day in `timezone`.
  * Binary-searches the boundary so it stays correct across DST transitions.
  */
-export const startOfCalendarDayInTz = (dateStr: string, timezone: string): Date => {
+export const startOfCalendarDayInTz = (
+  dateStr: string,
+  timezone: string,
+): Date => {
   const anchor = dateAtNoonUtc(dateStr).getTime();
   let low = anchor - 2 * DAY_MS;
   let high = anchor + DAY_MS;
@@ -109,8 +114,13 @@ export const startOfCalendarDayInTz = (dateStr: string, timezone: string): Date
 };
 
 /** UTC instant at the last millisecond of the given calendar day in `timezone`. */
-export const endOfCalendarDayInTz = (dateStr: string, timezone: string): Date => {
+export const endOfCalendarDayInTz = (
+  dateStr: string,
+  timezone: string,
+): Date => {
   const [y, m, d] = parseYmd(dateStr);
-  const nextDay = new Date(Date.UTC(y, m - 1, d + 1)).toISOString().slice(0, 10);
+  const nextDay = new Date(Date.UTC(y, m - 1, d + 1))
+    .toISOString()
+    .slice(0, 10);
   return new Date(startOfCalendarDayInTz(nextDay, timezone).getTime() - 1);
 };

package/README_OLD.md

@@ -1,160 +0,0 @@
-# @talkpilot/core-db
-
-[NPM Version](https://www.npmjs.com/package/@talkpilot/core-db)
-
-A TypeScript-based core database management package designed to provide centralized database connections, ORM integrations, and client utilities for other projects. This package manages connections to both **TalkPilot** and **Municipal** MongoDB databases.
-
-## Features
-
-- 🚀 **Multi-Domain Database Management**: Centralized handlers for both TalkPilot and Municipal Data domains.
-- 📦 **Reusable Getters**: Standardized functions for fetching data from various collections (calls, agents, leads, cities, etc.).
-- 🏗️ **Type-safe**: Built with TypeScript for full type safety across all your database interactions.
-- 🛠️ **Environment Aware**: Configurable via environment variables or explicit parameters.
-
-## Installation
-
-This package is intended to be used as a dependency in other projects. If you're working locally, you can install it using a file path:
-
-```bash
-# In your other project:
-npm install /path/to/core-db
-# or if published to a registry:
-npm install @talkpilot/core-db
-# or via GitHub
-npm install github:talkpilot/core-db
-```
-
-## Quick Start
-
-### 1. Initialize Database Connections
-
-You must initialize the database clients before using any of the getters.
-
-```typescript
-import { mongodbClient, municipalDataMongodbClient } from '@talkpilot/core-db';
-
-async function bootstrap() {
-  // Initialize TalkPilot DB
-  await mongodbClient.connect(process.env.TALKPILOT_MONGO_URI);
-
-  // Initialize Municipal Data DB (optional)
-  await municipalDataMongodbClient.connect(process.env.MUNICIPAL_MONGO_URI);
-}
-
-bootstrap().catch(console.error);
-```
-
-### 2. Using Getters
-
-Once initialized, you can import and use any of the exported database getters.
-
-```typescript
-import { findAgents, findCities } from '@talkpilot/core-db';
-
-async function getSummary() {
-  // Get all agents from TalkPilot DB
-  const agents = await findAgents();
-  console.log('Total Agents:', agents.length);
-
-  // Get all cities from Municipal Data DB
-  const cities = await findCities();
-  console.log('Total Cities:', cities.length);
-}
-```
-
-## Available Domains
-
-The package exports two main sets of tools:
-
-### TalkPilot Domain
-
-Includes access to:
-
-- `agents`, `calls`, `clients`, `flows`, `leads`, `phone_numbers`, `plans`, `results`, `sessions`, `subscriptions`, etc.
-- Exported as root level functions or via `mongodbClient`.
-
-### Municipal Domain
-
-Includes access to:
-
-- `cities`, `streets`, `departmentsSubjects`, `tickets`.
-- Functions are prefixed where necessary or accessible via `getMunicipalDataDb`.
-
-## Environment Variables
-
-The clients will automatically attempt to use the following environment variables if no URI is provided to the `connect()` method:
-
-- `MONGO_URI` or `MONGODB_URI`: Primary MongoDB connection string.
-- `MONGODB_DB_NAME`: Database name (defaults to 'municipal-data' for the municipal client if not specified).
-
-## Development
-
-### Setup
-
-1. Clone the repository and install dependencies:
-  ```bash
-   git clone https://github.com/talkpilot/core-db.git
-   cd core-db
-   npm install
-  ```
-2. Build the project:
-  ```bash
-   npm run build
-  ```
-
-This will generate the `dist/` directory with the compiled JavaScript and type definitions.
-
-### Publishing New Versions
-
-To publish a new version of the package:
-
-1. **Test your changes**:
-  ```bash
-   npm test
-  ```
-2. **Update the version**:
-  ```bash
-   # Bumps patch version (0.1.0 -> 0.1.1)
-   npm version patch
-   # Or for minor changes (0.1.0 -> 0.2.0)
-   # npm version minor
-   # Or for major changes (0.1.0 -> 1.0.0)
-   # npm version major
-  ```
-3. **Publish to npm**:
-  Ensure you have the shared team token in your `~/.npmrc` (see [Development Guide](./DEVELOPMENT.md#team-access--authentication)).
-4. **Update in other repos**:
-  ```bash
-   npm update @talkpilot/core-db
-  ```
-
-## License
-
-MIT
-
----
-
-**Interested in contributing?** Check out our [Development Guide](./DEVELOPMENT.md) for standards and setup instructions.
-
-## Release Notes
-
-### 1.1.9
-
-- `getPhoneNumbersForFlows(clientId)` — lists each phone number linked to a flow for that client (newest first), with `flowId`, `phoneNumber`, and `isPrimary`.
-### 1.1.5
-
-- `createPurchasedPhoneNumber` for API-bought numbers (Twilio/Telnyx metadata); optional `flowId` until linked to a flow. Types/schema updated accordingly.
-
-### 1.0.16
-
-- Fixed critical issues present in version 1.0.15.
-- **Warning**: Version 1.0.15 is bugged and should not be used. Please use at least version 1.0.16.  
-
-### 1.0.20
-
-- Added to Moked106Config this param: withNeedAttentionCalls
-- withNeedAttentionCalls?: boolean
-
-### 1.0.27
-- Added an optional `language` field to `ClientConfig` (e.g. Hebrew/English/Russian/French/Spanish) and updated tests.
-