@talkpilot/core-db 1.2.1 → 1.3.0

package/README.md

@@ -1,160 +1,169 @@
-# @talkpilot/core-db
+L1:# @talkpilot/core-db
 
-[NPM Version](https://www.npmjs.com/package/@talkpilot/core-db)
+`@talkpilot/core-db` is the shared TypeScript database package that wires TalkPilot APIs, municipal CRM integrations, and internal tools to a single, type-safe MongoDB surface. Every repo (MIS, CIS, TalkPilot Server, etc.) imports this package to avoid re-implementing connections, collections, or validation helpers.
 
-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.
+## Purpose
 
-## Features
+- Provide a reliable, multi-domain MongoDB layer for TalkPilot and municipal data.
+- Export typed getters, vector search helpers, and document factories so services can focus on behavior instead of schema wiring.
+- Manage connection lifecycles, environment configuration, and test helpers from one place so every repo reuses the same plumbing.
 
-- 🚀 **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.
+## Main Concepts
 
-## Installation
+- **Multi-domain clients** – `src/connection.ts` exposes `mongodbClient` (TalkPilot) and `municipalDataMongodbClient`, each of which resolves `MONGO_URI`, DB overrides, and default names.
+- **Domain-specific getters** – `src/talkpilot/` and `src/municipal/` host typed getters (agents, calls, streets, tickets, etc.), vector-search helpers, and service-friendly adapters that keep caller code DRY.
+- **Product-specific clients (future)** – While the package currently exposes the shared TalkPilot + municipal clients, we expect each product (CIS, MIS, TalkPilot Server) to eventually get its own domain-specific client helpers or wrappers so the shared core can remain stable while new consumers add targeted extensions.
+- **Test helpers** – `src/test-utils/` plus `src/__tests__/` reuse `MongoMemoryServer` and shared factories so tests start with clean data regardless of the consuming repo.
+- **Utility layers** – `src/utils/` contains shared validation, pagination, and environment helpers that complement the getters.
+- **Environment awareness** – Defaults, fallbacks, and `process.env` lookups ensure local, CI, and Cloud Run clients all connect using the right URI/DB names.
 
-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:
+## Key Components
 
-```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
-```
+- `src/connection.ts` – Central connection logic that resolves URIs/DB names from env vars (`MONGO_URI`, `MONGODB_URI`, `TALKPILOT_DB_NAME`, `MUNICIPAL_DB_NAME`) and reuses a single `MongoClient`.
+- `src/talkpilot/` – Call history, agents, flows, sessions, leads, subscriptions, and support helpers exposed as getters plus helper enums/types for each collection.
+- `src/municipal/` – Municipal-specific collections (`cities`, `streets`, `departmentsSubjects`, `tickets`, etc.) plus vector search helpers and Ash Bina helpers used by MIS.
+- `src/utils/` – Shared helpers such as `resolveConnection`, pagination utilities, and schema validation helper functions.
+- `src/test-utils/` and `src/__tests__/` – Utilities that bootstrap `MongoMemoryServer`, expose factories, and make sure Jest environments can stub database calls predictably.
+- `dist/` – Compiled output consumed by downstream repos (CJS + ESM + type defs).
 
-## Quick Start
+## Domain APIs
 
-### 1. Initialize Database Connections
+- **TalkPilot domain** – Imports like `findAgents`, `getFlows`, `findCalls`, and `vectorSearchCalls` live in `src/talkpilot`. These functions are the canonical access pattern for call history, session metadata, and provider configs.
+- **Municipal domain** – Helpers such as `findStreets`, `getMunicipalCities`, `findDepartmentSubjects`, and `createTicket` live under `src/municipal` and feed MIS workflows (street hints, subject matching, Ash Bina tickets).
 
-You must initialize the database clients before using any of the getters.
+## Environment variables
 
-```typescript
-import { mongodbClient, municipalDataMongodbClient } from '@talkpilot/core-db';
+| Variable                  | Purpose                                                                              | Required |
+|---------------------------|--------------------------------------------------------------------------------------|----------|
+| `MONGO_URI`               | Primary MongoDB connection string for every domain (overridden by `MONGODB_URI`).     | ✅        |
+| `MONGODB_URI`             | Alternate connection string used when Mongo needs a second URI parameter.             | ✅        |
+| `TALKPILOT_DB_NAME`        | Optional override for the TalkPilot database name (defaults from URI path).          | ❌        |
+| `MUNICIPAL_DB_NAME`        | Optional override for the municipal database name (defaults to `municipal-data`).     | ❌        |
+| `ENV`                     | Free-form label used in logs/validators (defaults to `unknown`).                      | ❌        |
 
-async function bootstrap() {
-  // Initialize TalkPilot DB
-  await mongodbClient.connect(process.env.TALKPILOT_MONGO_URI);
+If you pass a `uri` directly to `mongodbClient.connect()` or `municipalDataMongodbClient.connect()`, the client will prefer that value over the env vars.
 
-  // Initialize Municipal Data DB (optional)
-  await municipalDataMongodbClient.connect(process.env.MUNICIPAL_MONGO_URI);
-}
+## Getting Started
 
-bootstrap().catch(console.error);
-```
+### Prerequisites
 
-### 2. Using Getters
+- Node.js 22.x+ (aligns with downstream services).
+- npm 11+ or Yarn.
+- MongoDB accessible from your environment or a `MongoMemoryServer` for tests.
 
-Once initialized, you can import and use any of the exported database getters.
+### Setup
 
-```typescript
-import { findAgents, findCities } from '@talkpilot/core-db';
+1. Clone the repo and install dependencies:
+
+   ```bash
+   git clone https://github.com/talkpilot/core-db.git
+   cd core-db
+   npm install
+   ```
 
-async function getSummary() {
-  // Get all agents from TalkPilot DB
-  const agents = await findAgents();
-  console.log('Total Agents:', agents.length);
+2. Build the package before using it locally:
 
-  // Get all cities from Municipal Data DB
-  const cities = await findCities();
-  console.log('Total Cities:', cities.length);
-}
-```
+   ```bash
+   npm run build
+   ```
 
-## Available Domains
+3. Import `@talkpilot/core-db` from another project by pointing `package.json` at the local path during development or installing the published release.
 
-The package exports two main sets of tools:
+## Sample `.env`
 
-### TalkPilot Domain
+```
+MONGO_URI=mongodb://localhost:27017
+TALKPILOT_DB_NAME=talkpilot-dev
+MUNICIPAL_DB_NAME=municipal-dev
+ENV=development
+```
 
-Includes access to:
+Adjust `MONGO_URI` to match the running Mongo instance and configure `talkpilot`/`municipal` DB names if you want to keep them separate.
 
-- `agents`, `calls`, `clients`, `flows`, `leads`, `phone_numbers`, `plans`, `results`, `sessions`, `subscriptions`, etc.
-- Exported as root level functions or via `mongodbClient`.
+## Local development
 
-### Municipal Domain
+1. Run `npm install`.
+2. Build the compiled output: `npm run build`.
+3. Execute tests: `npm run test`.
+4. Use `npm link` or `npm pack` to consume the freshly built package from other repos (`CIS`, `MIS`, `TalkPilot Server`).
 
-Includes access to:
+## Development guide
 
-- `cities`, `streets`, `departmentsSubjects`, `tickets`.
-- Functions are prefixed where necessary or accessible via `getMunicipalDataDb`.
+`DEVELOPMENT.md` contains the tactical steps for contributors. At a glance:
 
-## Environment Variables
+- Node 18+/TypeScript is required (aligns with downstream services).
+- Run `npm install` → `npm run build` after cloning.
+- Use `npm link`/`npm link @talkpilot/core-db` to test the package locally before publishing.
+- When adding getters, define types, implement the function, export it through the domain `index.ts`, and add a corresponding test under the domain’s `__tests__` folder.
+- Always rely on the provided test factories (`src/test-utils/factories`) to seed data so tests remain consistent.
+- Jest with `mongodb-memory-server` is the only execution path we have to verify this core utility—unit tests are the safety net for every change.
 
-The clients will automatically attempt to use the following environment variables if no URI is provided to the `connect()` method:
+Refer to `DEVELOPMENT.md` for the full walkthrough, token instructions, and factory samples.
 
-- `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).
+## 🧪 Testing
 
-## Development
+- `npm run test` – Jest suite (factories, utils, integration mocks) powered by `mongodb-memory-server`.
+- Tests rely on `src/__tests__/setup.ts` to bootstrap the in-memory Mongo instances and wire shared factories/helpers before each run.
+- When adding getters, helpers, or domain logic, create focused coverage inside the consuming domain’s `__tests__/` folder and use the provided factories to keep fixtures consistent.
 
-### Setup
+`@talkpilot/core-db` does not run in a product UI or feature branch—unit tests are the *only* reliable execution path to ensure your changes work. Every change must ship with a unit test so downstream repos can upgrade without surprises; treat the test suite as the canonical safety net for this core utility package.
 
-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
-  ```
+## 🧹 Lint & build verification
 
-This will generate the `dist/` directory with the compiled JavaScript and type definitions.
+- `npm run lint` – Run ESLint over `src/**/*.{ts,tsx}`.
+- `npm run format` – Format the source files with Prettier.
+- `npm run build` – Compile TypeScript and emit `dist/` (used by downstream consumers).
 
-### Publishing New Versions
+## ✅ Pre-push checklist
 
-To publish a new version of the package:
+1. `npm run build`.
+2. `npm run test`.
+3. `npm run format`.
 
-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
-  ```
+## Publishing & release notes
 
-## License
+- Releases are handled by `npm version <patch|minor|major>` followed by `npm publish`. The package is a **private `@talkpilot` dependency**, so every contributor must install the shared npm automation token into their global `~/.npmrc` before running publish or `npm install`.
+- The shared token is rotated periodically—if you see authentication failures, request the refreshed token, update your `~/.npmrc`, and retry. Never commit credentials to source control.
+- After publishing, downstream repos (`CIS`, `MIS`, `TalkPilot Server`, etc.) should run `npm update @talkpilot/core-db` so they receive the latest helpers/bug fixes.
+- Cloud Build & Cloud Run jobs that depend on this package pick up the new version the next time they rebuild their container; the services pull the compiled `dist/` output and type definitions when installing the dependency.
 
-MIT
 
----
 
-**Interested in contributing?** Check out our [Development Guide](./DEVELOPMENT.md) for standards and setup instructions.
+| Version | Note                                                                                                                                                                                                                                                      |
+| ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| 1.1.9   | Maintenance release (build, test, format).                                                                                                                                                                                                                |
+| 1.2.0   | Added new statistics getters for call & ticket dashboards (CP-149): summary, trend, hourly, and routing for calls, plus open/draft/subject ticket stats. **Removed** the legacy getters `getTicketsCountByCityAndDateRange` and `getTicketsSubjectStats`. |
 
-## 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
+1. `npm run build`.
+2. `npm run test`.
+3. `npm run format`.
+
+### 1.2.0 — Call & ticket statistics (CP-149)
+
+New call statistics getters for dashboards (summary, trend, hourly, routing) and ticket statistics scoped to the same date range (open tickets, draft tickets, subject breakdowns).
+
+**Removed**
+
+| Removed | Replacement |
+| --- | --- |
+| `getTicketsCountByCityAndDateRange` | `aggregateCallsSummary` + `findCallSidsWithTicketsByCity` |
+| `getTicketsSubjectStats` | `findSubjectsByCallSids` |
+| `SubjectStatsItem` | `SubjectItem` |
 
-- `createPurchasedPhoneNumber` for API-bought numbers (Twilio/Telnyx metadata); optional `flowId` until linked to a flow. Types/schema updated accordingly.
+**Do I need to update my app?**
 
-### 1.0.16
+Yes — if you used any of the removed functions above.
 
-- 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.  
+## 🛠 CI/CD & deployment
 
-### 1.0.20
+- This package is consumed by Cloud Build-based services (TalkPilot Server, MIS, CIS) as a dependency when Docker images are built. Keep `dist/` in sync with your builds because the compiled artifact is what downstream services install.
+- Releases require the shared npm token documented in `DEVELOPMENT.md`; consult that guide for contribution, linking, and token rotation procedures.
 
-- Added to Moked106Config this param: withNeedAttentionCalls
-- withNeedAttentionCalls?: boolean
+## Resources
 
-### 1.0.27
-- Added an optional `language` field to `ClientConfig` (e.g. Hebrew/English/Russian/French/Spanish) and updated tests.
+- [DEVELOPMENT.md](./DEVELOPMENT.md) (setup, tooling, publishing, token management)
+- [src/test-utils](src/test-utils) and the `__tests__` folder for examples of `MongoMemoryServer` wiring.
 

package/README_OLD.md

@@ -0,0 +1,160 @@
+# @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/municipal/tickets/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./tickets.getters";
-export type { Ticket, TicketDoc, SubjectStatsItem } from "./tickets.types";
+export * from "./tickets.statistics.getters";
+export type { Ticket, TicketDoc, SubjectItem, TicketStatsDateScope } from "./tickets.types";
 //# sourceMappingURL=index.d.ts.map

package/dist/municipal/tickets/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/municipal/tickets/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/municipal/tickets/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,8BAA8B,CAAC;AAC7C,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/municipal/tickets/index.js

@@ -15,4 +15,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./tickets.getters"), exports);
+__exportStar(require("./tickets.statistics.getters"), exports);
 //# sourceMappingURL=index.js.map

package/dist/municipal/tickets/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/municipal/tickets/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAAkC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/municipal/tickets/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAAkC;AAClC,+DAA6C"}

package/dist/municipal/tickets/tickets.constants.d.ts

@@ -0,0 +1,7 @@
+/** Label used when a ticket has no resolvable department/subject. */
+export declare const UNCLASSIFIED = "\u05DC\u05DC\u05D0 \u05DE\u05D7\u05DC\u05E7\u05D4";
+/** Max execution time (ms) for ticket statistics aggregations. */
+export declare const STATS_MAX_TIME_MS = 30000;
+/** Default look-back window (days) for ticket statistics date ranges. */
+export declare const DEFAULT_LOOKBACK_DAYS = 30;
+//# sourceMappingURL=tickets.constants.d.ts.map

package/dist/municipal/tickets/tickets.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tickets.constants.d.ts","sourceRoot":"","sources":["../../../src/municipal/tickets/tickets.constants.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,eAAO,MAAM,YAAY,sDAAc,CAAC;AAExC,kEAAkE;AAClE,eAAO,MAAM,iBAAiB,QAAS,CAAC;AAExC,yEAAyE;AACzE,eAAO,MAAM,qBAAqB,KAAK,CAAC"}

package/dist/municipal/tickets/tickets.constants.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_LOOKBACK_DAYS = exports.STATS_MAX_TIME_MS = exports.UNCLASSIFIED = void 0;
+/** Label used when a ticket has no resolvable department/subject. */
+exports.UNCLASSIFIED = "ללא מחלקה";
+/** Max execution time (ms) for ticket statistics aggregations. */
+exports.STATS_MAX_TIME_MS = 30_000;
+/** Default look-back window (days) for ticket statistics date ranges. */
+exports.DEFAULT_LOOKBACK_DAYS = 30;
+//# sourceMappingURL=tickets.constants.js.map

package/dist/municipal/tickets/tickets.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tickets.constants.js","sourceRoot":"","sources":["../../../src/municipal/tickets/tickets.constants.ts"],"names":[],"mappings":";;;AAAA,qEAAqE;AACxD,QAAA,YAAY,GAAG,WAAW,CAAC;AAExC,kEAAkE;AACrD,QAAA,iBAAiB,GAAG,MAAM,CAAC;AAExC,yEAAyE;AAC5D,QAAA,qBAAqB,GAAG,EAAE,CAAC"}

package/dist/municipal/tickets/tickets.deprecated.getters.d.ts

@@ -0,0 +1,12 @@
+import type { SubjectStatsItem } from "./tickets.types";
+/**
+ * @deprecated Use `findCallSidsWithTicketsByCity` with `ticketStatsDateScopeFromYmd` instead.
+ * Will be removed in 3.0.0.
+ */
+export declare function getTicketsCountByCityAndDateRange(cityName: string, startStr: string, endStr: string, timezone: string): Promise<number>;
+/**
+ * @deprecated Use `findFilteredCallSids` + `findSubjectsByCallSids` instead.
+ * Will be removed in 3.0.0.
+ */
+export declare function getTicketsSubjectStats(cityName: string, startStr: string, endStr: string, timezone: string): Promise<SubjectStatsItem[]>;
+//# sourceMappingURL=tickets.deprecated.getters.d.ts.map

package/dist/municipal/tickets/tickets.deprecated.getters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tickets.deprecated.getters.d.ts","sourceRoot":"","sources":["../../../src/municipal/tickets/tickets.deprecated.getters.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD;;;GAGG;AACH,wBAAsB,iCAAiC,CACrD,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CAgBjB;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAoG7B"}

package/dist/municipal/tickets/tickets.deprecated.getters.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTicketsCountByCityAndDateRange = getTicketsCountByCityAndDateRange;
+exports.getTicketsSubjectStats = getTicketsSubjectStats;
+const tickets_getters_1 = require("./tickets.getters");
+/**
+ * @deprecated Use `findCallSidsWithTicketsByCity` with `ticketStatsDateScopeFromYmd` instead.
+ * Will be removed in 3.0.0.
+ */
+async function getTicketsCountByCityAndDateRange(cityName, startStr, endStr, timezone) {
+    const doc = await (0, tickets_getters_1.getTicketsCollection)()
+        .aggregate([
+        { $match: { cityName, callSid: { $exists: true, $nin: [null, ""] } } },
+        {
+            $addFields: {
+                dateLocal: {
+                    $dateToString: { format: "%Y-%m-%d", date: "$createdAt", timezone },
+                },
+            },
+        },
+        { $match: { dateLocal: { $gte: startStr, $lte: endStr } } },
+        { $count: "n" },
+    ])
+        .next();
+    return doc?.n ?? 0;
+}
+/**
+ * @deprecated Use `findFilteredCallSids` + `findSubjectsByCallSids` instead.
+ * Will be removed in 3.0.0.
+ */
+async function getTicketsSubjectStats(cityName, startStr, endStr, timezone) {
+    const rows = await (0, tickets_getters_1.getTicketsCollection)()
+        .aggregate([
+        { $match: { cityName } },
+        {
+            $addFields: {
+                dateLocal: {
+                    $dateToString: { format: "%Y-%m-%d", date: "$createdAt", timezone },
+                },
+            },
+        },
+        { $match: { dateLocal: { $gte: startStr, $lte: endStr } } },
+        {
+            $addFields: {
+                effectiveSubjectId: {
+                    $ifNull: [
+                        "$externalCallFields.event_subject_id",
+                        {
+                            $ifNull: [
+                                "$externalCallFields.event_sub_subject_id",
+                                "$externalCallFields.event_sub_subject_id2",
+                            ],
+                        },
+                    ],
+                },
+            },
+        },
+        {
+            $lookup: {
+                from: "departmentsSubjects",
+                let: { sid: "$effectiveSubjectId", c: cityName },
+                pipeline: [
+                    {
+                        $match: {
+                            $expr: {
+                                $and: [
+                                    { $eq: ["$cityName", "$$c"] },
+                                    {
+                                        $or: [
+                                            { $eq: ["$subject_id", { $ifNull: ["$$sid", ""] }] },
+                                            {
+                                                $eq: ["$sub_subject_id", { $ifNull: ["$$sid", ""] }],
+                                            },
+                                            {
+                                                $eq: ["$sub_subject_id2", { $ifNull: ["$$sid", ""] }],
+                                            },
+                                        ],
+                                    },
+                                ],
+                            },
+                        },
+                    },
+                    { $limit: 1 },
+                ],
+                as: "subj",
+            },
+        },
+        {
+            $addFields: {
+                subject_id: {
+                    $cond: {
+                        if: { $gt: [{ $size: "$subj" }, 0] },
+                        then: {
+                            $ifNull: [{ $arrayElemAt: ["$subj.subject_id", 0] }, ""],
+                        },
+                        else: "",
+                    },
+                },
+                subject: {
+                    $cond: {
+                        if: { $gt: [{ $size: "$subj" }, 0] },
+                        then: {
+                            $ifNull: [
+                                { $arrayElemAt: ["$subj.subjectName", 0] },
+                                "Unclassified",
+                            ],
+                        },
+                        else: "Unclassified",
+                    },
+                },
+            },
+        },
+        {
+            $group: {
+                _id: "$subject_id",
+                subject: { $first: "$subject" },
+                count: { $sum: 1 },
+            },
+        },
+        { $sort: { count: -1 } },
+    ])
+        .toArray();
+    const total = rows.reduce((sum, row) => sum + row.count, 0);
+    return rows.map((row) => ({
+        subject_name: row.subject,
+        subject_id: row._id,
+        count: row.count,
+        percentage: total > 0 ? Math.round((row.count / total) * 100) : 0,
+    }));
+}
+//# sourceMappingURL=tickets.deprecated.getters.js.map

package/dist/municipal/tickets/tickets.deprecated.getters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tickets.deprecated.getters.js","sourceRoot":"","sources":["../../../src/municipal/tickets/tickets.deprecated.getters.ts"],"names":[],"mappings":"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"}