@talkpilot/core-db 1.3.12 → 1.3.13

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

@@ -1,44 +1,44 @@
-import { getProductsCollection, getAllProducts } from "../products.getters";
-import { ObjectId } from "../../index";
-
-describe("products getters", () => {
-  it('should return the "products" collection', () => {
-    const collection = getProductsCollection();
-    expect(collection.collectionName).toBe("products");
-  });
-
-  it("should return all product documents", async () => {
-    await getProductsCollection().insertMany([
-      { _id: new ObjectId(), name: "Municipal" },
-      { _id: new ObjectId(), name: "Clinics" },
-    ]);
-
-    const results = await getAllProducts();
-    expect(results.length).toBeGreaterThanOrEqual(2);
-    expect(results.map((p) => p.name)).toEqual(
-      expect.arrayContaining(["Municipal", "Clinics"]),
-    );
-  });
-
-  it("should store and retrieve displayName locale map", async () => {
-    const id = new ObjectId();
-    await getProductsCollection().insertOne({
-      _id: id,
-      name: "Municipal",
-      displayName: { he: "עירייה", en: "Municipal" },
-    });
-
-    const results = await getAllProducts();
-    const saved = results.find((p) => p._id.equals(id));
-    expect(saved?.displayName).toEqual({ he: "עירייה", en: "Municipal" });
-  });
-
-  it("should return products without displayName without error", async () => {
-    const id = new ObjectId();
-    await getProductsCollection().insertOne({ _id: id, name: "Rcure" });
-
-    const results = await getAllProducts();
-    const saved = results.find((p) => p._id.equals(id));
-    expect(saved?.displayName).toBeUndefined();
-  });
-});
+import { getProductsCollection, getAllProducts } from "../products.getters";
+import { ObjectId } from "../../index";
+
+describe("products getters", () => {
+  it('should return the "products" collection', () => {
+    const collection = getProductsCollection();
+    expect(collection.collectionName).toBe("products");
+  });
+
+  it("should return all product documents", async () => {
+    await getProductsCollection().insertMany([
+      { _id: new ObjectId(), name: "Municipal" },
+      { _id: new ObjectId(), name: "Clinics" },
+    ]);
+
+    const results = await getAllProducts();
+    expect(results.length).toBeGreaterThanOrEqual(2);
+    expect(results.map((p) => p.name)).toEqual(
+      expect.arrayContaining(["Municipal", "Clinics"]),
+    );
+  });
+
+  it("should store and retrieve displayName locale map", async () => {
+    const id = new ObjectId();
+    await getProductsCollection().insertOne({
+      _id: id,
+      name: "Municipal",
+      displayName: { he: "עירייה", en: "Municipal" },
+    });
+
+    const results = await getAllProducts();
+    const saved = results.find((p) => p._id.equals(id));
+    expect(saved?.displayName).toEqual({ he: "עירייה", en: "Municipal" });
+  });
+
+  it("should return products without displayName without error", async () => {
+    const id = new ObjectId();
+    await getProductsCollection().insertOne({ _id: id, name: "Rcure" });
+
+    const results = await getAllProducts();
+    const saved = results.find((p) => p._id.equals(id));
+    expect(saved?.displayName).toBeUndefined();
+  });
+});

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

@@ -1,40 +1,40 @@
-import { Factory } from "fishery";
-import { ObjectId } from "mongodb";
-import { faker } from "@faker-js/faker";
-import type { ContextNote, ContextNoteEntry } from "../../../talkpilot";
-
-export const contextNoteEntryFactory = Factory.define<ContextNoteEntry>(() => ({
-  _id: new ObjectId(),
-  title: faker.lorem.words(3),
-  content: faker.lorem.sentences(2),
-  activeFrom: new Date(),
-  expiresAt: null,
-  createdAt: new Date(),
-  updatedAt: new Date(),
-}));
-
-export const contextNoteFactory = Factory.define<
-  ContextNote & { _id: ObjectId }
->(() => ({
-  _id: new ObjectId(),
-  clientId: faker.string.uuid(),
-  product: "Municipal",
-  notes: [],
-}));
-
-export function createContextNoteEntry(
-  overrides?: Partial<ContextNoteEntry>,
-): ContextNoteEntry {
-  return {
-    ...contextNoteEntryFactory.build(),
-    ...overrides,
-  } as ContextNoteEntry;
-}
-
-export function createContextNote(
-  overrides?: Partial<ContextNote>,
-): ContextNote & { _id: ObjectId } {
-  return { ...contextNoteFactory.build(), ...overrides } as ContextNote & {
-    _id: ObjectId;
-  };
-}
+import { Factory } from "fishery";
+import { ObjectId } from "mongodb";
+import { faker } from "@faker-js/faker";
+import type { ContextNote, ContextNoteEntry } from "../../../talkpilot";
+
+export const contextNoteEntryFactory = Factory.define<ContextNoteEntry>(() => ({
+  _id: new ObjectId(),
+  title: faker.lorem.words(3),
+  content: faker.lorem.sentences(2),
+  activeFrom: new Date(),
+  expiresAt: null,
+  createdAt: new Date(),
+  updatedAt: new Date(),
+}));
+
+export const contextNoteFactory = Factory.define<
+  ContextNote & { _id: ObjectId }
+>(() => ({
+  _id: new ObjectId(),
+  clientId: faker.string.uuid(),
+  product: "Municipal",
+  notes: [],
+}));
+
+export function createContextNoteEntry(
+  overrides?: Partial<ContextNoteEntry>,
+): ContextNoteEntry {
+  return {
+    ...contextNoteEntryFactory.build(),
+    ...overrides,
+  } as ContextNoteEntry;
+}
+
+export function createContextNote(
+  overrides?: Partial<ContextNote>,
+): 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

@@ -1,126 +1,126 @@
-/**
- * Shared timezone-aware date helpers for statistics aggregations.
- */
-
-/** Milliseconds in a single day. */
-export const DAY_MS = 24 * 60 * 60 * 1000;
-
-/** Maps a short weekday name (as produced by Intl) to its index (Sun = 0). */
-export const WEEKDAY: Record<string, number> = {
-  Sun: 0,
-  Mon: 1,
-  Tue: 2,
-  Wed: 3,
-  Thu: 4,
-  Fri: 5,
-  Sat: 6,
-};
-
-/** Parses a `YYYY-MM-DD` string into `[year, month, day]` numbers. */
-export const parseYmd = (dateStr: string): [number, number, number] => {
-  const [y, m, d] = dateStr.split("-").map(Number);
-  return [y, m, d];
-};
-
-/** Builds a zero-padded `YYYY-MM-DD` string from numeric parts. */
-export const ymdToStr = (y: number, m: number, d: number): string =>
-  `${y}-${String(m).padStart(2, "0")}-${String(d).padStart(2, "0")}`;
-
-/** Parses a `YYYY-MM-DD` string as midnight UTC. */
-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);
-
-/** Adds `days` to a `YYYY-MM-DD` string, returning the resulting `YYYY-MM-DD`. */
-export const addDaysToDateStr = (dateStr: string, days: number): string =>
-  formatDate(new Date(toUtcDate(dateStr).getTime() + days * DAY_MS));
-
-/** Next civil calendar day (proleptic Gregorian). Avoids DST 24h steps that can stall iteration. */
-export const incrementYmd = (
-  y: number,
-  m: number,
-  d: number,
-): [number, number, number] => {
-  const next = new Date(Date.UTC(y, m - 1, d + 1));
-  return [next.getUTCFullYear(), next.getUTCMonth() + 1, next.getUTCDate()];
-};
-
-/**
- * Formats a date as the calendar day in the given timezone.
- * `en-CA` yields ISO-8601 `YYYY-MM-DD`, which is lexicographically sortable
- * (string compare == chronological compare) and matches MongoDB's `%Y-%m-%d`.
- */
-export const formatYmdInTz = (date: Date, timezone: string): string =>
-  new Intl.DateTimeFormat("en-CA", { timeZone: timezone }).format(date);
-
-/**
- * Returns the calendar day in the given timezone as numeric parts.
- * Reads parts by `type` (not string order), so `en-US` is fine here.
- */
-export const getYmdInTz = (date: Date, timezone: string) => {
-  const parts = Object.fromEntries(
-    new Intl.DateTimeFormat("en-US", {
-      timeZone: timezone,
-      year: "numeric",
-      month: "numeric",
-      day: "numeric",
-    })
-      .formatToParts(date)
-      .map((p) => [p.type, Number(p.value)]),
-  );
-  return { y: parts.year, m: parts.month, d: parts.day };
-};
-
-/** 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)
-  ] ?? 0;
-
-/**
- * Returns the given `YYYY-MM-DD` day at noon UTC — a stable anchor inside the
- * calendar day, far from midnight so timezone/DST shifts can't cross a date boundary.
- */
-export const dateAtNoonUtc = (dateStr: string): Date => {
-  const [y, m, d] = parseYmd(dateStr);
-  return new Date(Date.UTC(y, m - 1, d, 12, 0, 0));
-};
-
-/**
- * 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 => {
-  const anchor = dateAtNoonUtc(dateStr).getTime();
-  let low = anchor - 2 * DAY_MS;
-  let high = anchor + DAY_MS;
-
-  while (high - low > 1 /* ms */) {
-    const mid = Math.floor((low + high) / 2);
-    if (formatYmdInTz(new Date(mid), timezone) >= dateStr) high = mid;
-    else low = mid;
-  }
-
-  return new Date(high);
-};
-
-/** UTC instant at the last millisecond of the given calendar day in `timezone`. */
-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);
-  return new Date(startOfCalendarDayInTz(nextDay, timezone).getTime() - 1);
-};
+/**
+ * Shared timezone-aware date helpers for statistics aggregations.
+ */
+
+/** Milliseconds in a single day. */
+export const DAY_MS = 24 * 60 * 60 * 1000;
+
+/** Maps a short weekday name (as produced by Intl) to its index (Sun = 0). */
+export const WEEKDAY: Record<string, number> = {
+  Sun: 0,
+  Mon: 1,
+  Tue: 2,
+  Wed: 3,
+  Thu: 4,
+  Fri: 5,
+  Sat: 6,
+};
+
+/** Parses a `YYYY-MM-DD` string into `[year, month, day]` numbers. */
+export const parseYmd = (dateStr: string): [number, number, number] => {
+  const [y, m, d] = dateStr.split("-").map(Number);
+  return [y, m, d];
+};
+
+/** Builds a zero-padded `YYYY-MM-DD` string from numeric parts. */
+export const ymdToStr = (y: number, m: number, d: number): string =>
+  `${y}-${String(m).padStart(2, "0")}-${String(d).padStart(2, "0")}`;
+
+/** Parses a `YYYY-MM-DD` string as midnight UTC. */
+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);
+
+/** Adds `days` to a `YYYY-MM-DD` string, returning the resulting `YYYY-MM-DD`. */
+export const addDaysToDateStr = (dateStr: string, days: number): string =>
+  formatDate(new Date(toUtcDate(dateStr).getTime() + days * DAY_MS));
+
+/** Next civil calendar day (proleptic Gregorian). Avoids DST 24h steps that can stall iteration. */
+export const incrementYmd = (
+  y: number,
+  m: number,
+  d: number,
+): [number, number, number] => {
+  const next = new Date(Date.UTC(y, m - 1, d + 1));
+  return [next.getUTCFullYear(), next.getUTCMonth() + 1, next.getUTCDate()];
+};
+
+/**
+ * Formats a date as the calendar day in the given timezone.
+ * `en-CA` yields ISO-8601 `YYYY-MM-DD`, which is lexicographically sortable
+ * (string compare == chronological compare) and matches MongoDB's `%Y-%m-%d`.
+ */
+export const formatYmdInTz = (date: Date, timezone: string): string =>
+  new Intl.DateTimeFormat("en-CA", { timeZone: timezone }).format(date);
+
+/**
+ * Returns the calendar day in the given timezone as numeric parts.
+ * Reads parts by `type` (not string order), so `en-US` is fine here.
+ */
+export const getYmdInTz = (date: Date, timezone: string) => {
+  const parts = Object.fromEntries(
+    new Intl.DateTimeFormat("en-US", {
+      timeZone: timezone,
+      year: "numeric",
+      month: "numeric",
+      day: "numeric",
+    })
+      .formatToParts(date)
+      .map((p) => [p.type, Number(p.value)]),
+  );
+  return { y: parts.year, m: parts.month, d: parts.day };
+};
+
+/** 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)
+  ] ?? 0;
+
+/**
+ * Returns the given `YYYY-MM-DD` day at noon UTC — a stable anchor inside the
+ * calendar day, far from midnight so timezone/DST shifts can't cross a date boundary.
+ */
+export const dateAtNoonUtc = (dateStr: string): Date => {
+  const [y, m, d] = parseYmd(dateStr);
+  return new Date(Date.UTC(y, m - 1, d, 12, 0, 0));
+};
+
+/**
+ * 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 => {
+  const anchor = dateAtNoonUtc(dateStr).getTime();
+  let low = anchor - 2 * DAY_MS;
+  let high = anchor + DAY_MS;
+
+  while (high - low > 1 /* ms */) {
+    const mid = Math.floor((low + high) / 2);
+    if (formatYmdInTz(new Date(mid), timezone) >= dateStr) high = mid;
+    else low = mid;
+  }
+
+  return new Date(high);
+};
+
+/** UTC instant at the last millisecond of the given calendar day in `timezone`. */
+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);
+  return new Date(startOfCalendarDayInTz(nextDay, timezone).getTime() - 1);
+};

package/tsconfig.json

@@ -1,23 +1,23 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "CommonJS",
-    "moduleResolution": "node",
-    "lib": ["ES2022"],
-    "declaration": true,
-    "declarationMap": true,
-    "sourceMap": true,
-    "outDir": "dist",
-    "rootDir": "src",
-    "strict": true,
-    "esModuleInterop": true,
-    "forceConsistentCasingInFileNames": true,
-    "skipLibCheck": true,
-    "resolveJsonModule": true,
-    "experimentalDecorators": true,
-    "emitDecoratorMetadata": true,
-    "baseUrl": "."
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist", "test", "**/*.test.ts", "**/__tests__/*", "**/*.spec.ts"]
-}
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "CommonJS",
+    "moduleResolution": "node",
+    "lib": ["ES2022"],
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true,
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true,
+    "baseUrl": "."
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "test", "**/*.test.ts", "**/__tests__/*", "**/*.spec.ts"]
+}

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.
-

package/dist/talkpilot/calls/calls.dashboard.d.ts

@@ -1,3 +0,0 @@
-import { DashboardStatsParams, DashboardStatsResult } from "./calls.types";
-export declare function getDashboardStats(params: DashboardStatsParams): Promise<DashboardStatsResult>;
-//# sourceMappingURL=calls.dashboard.d.ts.map

package/dist/talkpilot/calls/calls.dashboard.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"calls.dashboard.d.ts","sourceRoot":"","sources":["../../../src/talkpilot/calls/calls.dashboard.ts"],"names":[],"mappings":"AAEA,OAAO,EAA8B,oBAAoB,EAAE,oBAAoB,EAAiD,MAAM,eAAe,CAAC;AAmGtJ,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,oBAAoB,CAAC,CAuG/B"}