@talkpilot/core-db 1.0.1

package/.cursor/rules/development.mdc

@@ -0,0 +1,65 @@
+---
+description: Development standards and conventions for the core-db package
+globs: src/**/*.ts
+alwaysApply: true
+---
+
+# Development Standards
+
+This package provides a centralized database layer for multiple domains (TalkPilot and Municipal). Follow these rules to maintain consistency and reliability.
+
+## Project Structure
+
+- **`src/talkpilot/`**: All database logic, types, and getters related to the TalkPilot domain.
+- **`src/municipal/`**: All database logic, types, and getters related to the Municipal Data domain.
+- **`src/test-utils/`**: Shared testing infrastructure, including factories and database utilities.
+
+## Database Connection Pattern
+
+Each domain is isolated. They have their own `db` instance and must be connected independently.
+
+```typescript
+import { mongodbClient, municipalDataMongodbClient } from '@talk-pilot/core-db';
+
+// TalkPilot
+await mongodbClient.connect(uri);
+
+// Municipal
+await municipalDataMongodbClient.connect(uri);
+```
+
+## Creating New Getters
+
+1. **Location**: Place getters in the relevant domain folder (e.g., `src/talkpilot/agents/agents.getters.ts`).
+2. **Naming**: Use `find...` for multiple results and `get...ById` for single results.
+3. **Domain isolation**: Always use the `getDb()` function from the current domain's `index.ts`.
+
+## Environment Validation
+
+Always validate configuration "on-demand" within the `connect` methods using the validation utilities.
+
+```typescript
+import { validateConfig, validateMongoUri } from '../utils/validation';
+
+async connect(uri?: string) {
+  const mongodbUri = uri || process.env.MONGO_URI;
+  validateConfig('MONGO_URI', mongodbUri);
+  validateMongoUri(mongodbUri!);
+  // ... connection logic
+}
+```
+
+## Testing Standards
+
+1. **In-Memory DB**: Use `mongodb-memory-server` for all tests. It is automatically initialized in `src/__tests__/setup.ts`.
+2. **Factories**: Use the Fishery factories in `src/test-utils/factories/` to generate test data.
+3. **Organization**: Place tests in a `__tests__` folder within the relevant domain.
+
+```typescript
+import { createAgent } from '../../../test-utils/factories';
+
+it('should find agents', async () => {
+  const agent = createAgent({ name: 'Test' });
+  // ... test logic
+});
+```

package/DEVELOPMENT.md

@@ -0,0 +1,98 @@
+# Development Guide
+
+Welcome to the `core-db` development guide. This document explains how to set up, develop, and test this package.
+
+## Getting Started
+
+### Prerequisites
+
+- Node.js (v18 or later)
+- TypeScript
+
+### Setup
+
+1. Install dependencies:
+   ```bash
+   npm install
+   ```
+
+2. Build the project:
+   ```bash
+   npm run build
+   ```
+
+## Local Development
+
+If you want to use this package in another project locally without publishing it:
+
+1. In the `core-db` folder:
+   ```bash
+   npm link
+   ```
+
+2. In your PROJECT folder:
+   ```bash
+   npm link @talk-pilot/core-db
+   ```
+
+## Adding a New Getter
+
+1. **Define Types**: Add your data types in the relevant domain's `types.ts` file.
+2. **Implement Getter**: Add the function in the `getters.ts` file.
+3. **Export**: Ensure the getter is exported from the domain's `index.ts` and finally from the main `src/index.ts`.
+4. **Test**: Create a test in the domain's `__tests__` folder.
+
+## Testing
+
+We use Jest with `mongodb-memory-server` for fast, isolated database tests.
+
+### Running Tests
+
+```bash
+npm test
+```
+
+### Using Factories
+
+Always use factories to generate test data to keep tests clean and maintainable.
+
+```typescript
+import { createCallDoc } from '../calls.getters';
+import { createOutGoingCallDoc } from '../../../test-utils/factories';
+
+it('should save a call', async () => {
+  const call = createOutGoingCallDoc({ callSid: 'CA123' });
+  await createCallDoc(call);
+  // ... assertions
+});
+```
+
+## Build Process
+
+The project is built using TypeScript (`tsc`). The output is generated in the `dist/` directory.
+
+- `main`: `dist/index.js`
+- `types`: `dist/index.d.ts`
+
+The `prepare` script in `package.json` ensures that the project is built automatically when installed via a Git URL.
+
+## Team Access & Authentication
+
+To allow the whole team to publish and install without adding individual npm accounts, we use a shared **npm Granular Access Token**.
+
+### One-time Local Setup
+
+Each developer needs to add the shared token to their local npm configuration. Do **NOT** add this to the project's `.npmrc` file, as it will be committed to Git.
+
+1. Get the shared **npm Automation Token**.
+2. Open (or create) your global npm configuration file:
+   ```bash
+   nano ~/.npmrc
+   ```
+3. Add the following line (replace `[TOKEN]` with the actual token):
+   ```text
+   //registry.npmjs.org/:_authToken=[TOKEN]
+   ```
+4. Save and exit.
+
+Now you can run `npm publish` and `npm install` for scoped `@talk-pilot` packages without being prompted for credentials.

package/README.md

@@ -0,0 +1,140 @@
+# @talk-pilot/core-db
+
+[![NPM Version](https://img.shields.io/npm/v/@talk-pilot/core-db)](https://www.npmjs.com/package/@talk-pilot/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 @talk-pilot/core-db
+# or via GitHub (ensure you have built or have a prepare script)
+npm install github:Talk-Pilot/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 '@talk-pilot/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 '@talk-pilot/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/Talk-Pilot/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)).
+   ```bash
+   npm publish
+   ```
+
+4. **Update in other repos**:
+   ```bash
+   npm update @talk-pilot/core-db
+   ```
+
+## License
+
+MIT
+
+---
+
+**Interested in contributing?** Check out our [Development Guide](./DEVELOPMENT.md) for standards and setup instructions.

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from './talkpilot';
+export { municipalDataMongodbClient, getDb as getMunicipalDataDb, setDb as setMunicipalDataDb, ObjectId as MunicipalDataObjectId, } from './municipal';
+export * from './municipal/cities';
+export * from './municipal/streets';
+export * from './municipal/departmentsSubjects';
+export * from './municipal/tickets';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAC;AAE5B,OAAO,EACL,0BAA0B,EAC1B,KAAK,IAAI,kBAAkB,EAC3B,KAAK,IAAI,kBAAkB,EAC3B,QAAQ,IAAI,qBAAqB,GAClC,MAAM,aAAa,CAAC;AACrB,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iCAAiC,CAAC;AAChD,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,29 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MunicipalDataObjectId = exports.setMunicipalDataDb = exports.getMunicipalDataDb = exports.municipalDataMongodbClient = void 0;
+// TalkPilot DB exports
+__exportStar(require("./talkpilot"), exports);
+var municipal_1 = require("./municipal");
+Object.defineProperty(exports, "municipalDataMongodbClient", { enumerable: true, get: function () { return municipal_1.municipalDataMongodbClient; } });
+Object.defineProperty(exports, "getMunicipalDataDb", { enumerable: true, get: function () { return municipal_1.getDb; } });
+Object.defineProperty(exports, "setMunicipalDataDb", { enumerable: true, get: function () { return municipal_1.setDb; } });
+Object.defineProperty(exports, "MunicipalDataObjectId", { enumerable: true, get: function () { return municipal_1.ObjectId; } });
+__exportStar(require("./municipal/cities"), exports);
+__exportStar(require("./municipal/streets"), exports);
+__exportStar(require("./municipal/departmentsSubjects"), exports);
+__exportStar(require("./municipal/tickets"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,uBAAuB;AACvB,8CAA4B;AAE5B,yCAKqB;AAJnB,uHAAA,0BAA0B,OAAA;AAC1B,+GAAA,KAAK,OAAsB;AAC3B,+GAAA,KAAK,OAAsB;AAC3B,kHAAA,QAAQ,OAAyB;AAEnC,qDAAmC;AACnC,sDAAoC;AACpC,kEAAgD;AAChD,sDAAoC"}

package/dist/municipal/cities/cities.getters.d.ts

@@ -0,0 +1,9 @@
+import { City } from '../index';
+import { Collection, Filter, ObjectId as MongoObjectId } from 'mongodb';
+export declare const getCitiesCollection: () => Collection<City>;
+export declare const findCities: (filter?: Filter<City>) => Promise<City[]>;
+export declare const getCityById: (cityId: string) => Promise<City | null>;
+export declare const createCity: (cityData: Omit<City, "_id" | "createdAt" | "updatedAt">) => Promise<MongoObjectId>;
+export declare const updateCity: (cityId: string, data: Partial<Omit<City, "_id" | "createdAt" | "updatedAt">>) => Promise<City | null>;
+export declare const deleteCity: (cityId: string) => Promise<boolean>;
+//# sourceMappingURL=cities.getters.d.ts.map

package/dist/municipal/cities/cities.getters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cities.getters.d.ts","sourceRoot":"","sources":["../../../src/municipal/cities/cities.getters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,IAAI,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,IAAI,aAAa,EAAE,MAAM,SAAS,CAAC;AAExE,eAAO,MAAM,mBAAmB,QAAO,UAAU,CAAC,IAAI,CAErD,CAAC;AAEF,eAAO,MAAM,UAAU,GAAU,SAAQ,MAAM,CAAC,IAAI,CAAM,KAAG,OAAO,CAAC,IAAI,EAAE,CAE1E,CAAC;AAEF,eAAO,MAAM,WAAW,GAAU,QAAQ,MAAM,KAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAGrE,CAAC;AAEF,eAAO,MAAM,UAAU,GACrB,UAAU,IAAI,CAAC,IAAI,EAAE,KAAK,GAAG,WAAW,GAAG,WAAW,CAAC,KACtD,OAAO,CAAC,aAAa,CAQvB,CAAC;AAEF,eAAO,MAAM,UAAU,GACrB,QAAQ,MAAM,EACd,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,GAAG,WAAW,GAAG,WAAW,CAAC,CAAC,KAC3D,OAAO,CAAC,IAAI,GAAG,IAAI,CAOrB,CAAC;AAEF,eAAO,MAAM,UAAU,GAAU,QAAQ,MAAM,KAAG,OAAO,CAAC,OAAO,CAGhE,CAAC"}

package/dist/municipal/cities/cities.getters.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deleteCity = exports.updateCity = exports.createCity = exports.getCityById = exports.findCities = exports.getCitiesCollection = void 0;
+const index_1 = require("../index");
+const getCitiesCollection = () => {
+    return (0, index_1.getDb)().collection('cities');
+};
+exports.getCitiesCollection = getCitiesCollection;
+const findCities = async (filter = {}) => {
+    return await (0, exports.getCitiesCollection)().find(filter).toArray();
+};
+exports.findCities = findCities;
+const getCityById = async (cityId) => {
+    const city = await (0, exports.getCitiesCollection)().findOne({ _id: new index_1.ObjectId(cityId) });
+    return city ? city : null;
+};
+exports.getCityById = getCityById;
+const createCity = async (cityData) => {
+    const city = {
+        ...cityData,
+        createdAt: new Date(),
+        updatedAt: new Date(),
+    };
+    const { insertedId } = await (0, exports.getCitiesCollection)().insertOne(city);
+    return insertedId;
+};
+exports.createCity = createCity;
+const updateCity = async (cityId, data) => {
+    const result = await (0, exports.getCitiesCollection)().findOneAndUpdate({ _id: new index_1.ObjectId(cityId) }, { $set: { ...data, updatedAt: new Date() } }, { returnDocument: 'after' });
+    return result || null;
+};
+exports.updateCity = updateCity;
+const deleteCity = async (cityId) => {
+    const result = await (0, exports.getCitiesCollection)().deleteOne({ _id: new index_1.ObjectId(cityId) });
+    return result.deletedCount > 0;
+};
+exports.deleteCity = deleteCity;
+//# sourceMappingURL=cities.getters.js.map

package/dist/municipal/cities/cities.getters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cities.getters.js","sourceRoot":"","sources":["../../../src/municipal/cities/cities.getters.ts"],"names":[],"mappings":";;;AAAA,oCAAiD;AAG1C,MAAM,mBAAmB,GAAG,GAAqB,EAAE;IACxD,OAAO,IAAA,aAAK,GAAE,CAAC,UAAU,CAAO,QAAQ,CAAC,CAAC;AAC5C,CAAC,CAAC;AAFW,QAAA,mBAAmB,uBAE9B;AAEK,MAAM,UAAU,GAAG,KAAK,EAAE,SAAuB,EAAE,EAAmB,EAAE;IAC7E,OAAO,MAAM,IAAA,2BAAmB,GAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;AAC5D,CAAC,CAAC;AAFW,QAAA,UAAU,cAErB;AAEK,MAAM,WAAW,GAAG,KAAK,EAAE,MAAc,EAAwB,EAAE;IACxE,MAAM,IAAI,GAAG,MAAM,IAAA,2BAAmB,GAAE,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,IAAI,gBAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAChF,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5B,CAAC,CAAC;AAHW,QAAA,WAAW,eAGtB;AAEK,MAAM,UAAU,GAAG,KAAK,EAC7B,QAAuD,EAC/B,EAAE;IAC1B,MAAM,IAAI,GAAsB;QAC9B,GAAG,QAAQ;QACX,SAAS,EAAE,IAAI,IAAI,EAAE;QACrB,SAAS,EAAE,IAAI,IAAI,EAAE;KACtB,CAAC;IACF,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,IAAA,2BAAmB,GAAE,CAAC,SAAS,CAAC,IAAY,CAAC,CAAC;IAC3E,OAAO,UAAU,CAAC;AACpB,CAAC,CAAC;AAVW,QAAA,UAAU,cAUrB;AAEK,MAAM,UAAU,GAAG,KAAK,EAC7B,MAAc,EACd,IAA4D,EACtC,EAAE;IACxB,MAAM,MAAM,GAAG,MAAM,IAAA,2BAAmB,GAAE,CAAC,gBAAgB,CACzD,EAAE,GAAG,EAAE,IAAI,gBAAQ,CAAC,MAAM,CAAC,EAAE,EAC7B,EAAE,IAAI,EAAE,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,EAAE,EAAE,EAC5C,EAAE,cAAc,EAAE,OAAO,EAAE,CAC5B,CAAC;IACF,OAAO,MAAM,IAAI,IAAI,CAAC;AACxB,CAAC,CAAC;AAVW,QAAA,UAAU,cAUrB;AAEK,MAAM,UAAU,GAAG,KAAK,EAAE,MAAc,EAAoB,EAAE;IACnE,MAAM,MAAM,GAAG,MAAM,IAAA,2BAAmB,GAAE,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,IAAI,gBAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACpF,OAAO,MAAM,CAAC,YAAY,GAAG,CAAC,CAAC;AACjC,CAAC,CAAC;AAHW,QAAA,UAAU,cAGrB"}

package/dist/municipal/cities/cities.types.d.ts

@@ -0,0 +1,10 @@
+import { ObjectId, WithId } from 'mongodb';
+export type City = {
+    _id: ObjectId;
+    createdAt: Date;
+    updatedAt: Date;
+    name: string;
+    displayName: string;
+};
+export type CityDoc = WithId<City>;
+//# sourceMappingURL=cities.types.d.ts.map

package/dist/municipal/cities/cities.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cities.types.d.ts","sourceRoot":"","sources":["../../../src/municipal/cities/cities.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAE3C,MAAM,MAAM,IAAI,GAAG;IACjB,GAAG,EAAE,QAAQ,CAAC;IACd,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC"}

package/dist/municipal/cities/cities.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=cities.types.js.map

package/dist/municipal/cities/cities.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cities.types.js","sourceRoot":"","sources":["../../../src/municipal/cities/cities.types.ts"],"names":[],"mappings":""}

package/dist/municipal/cities/index.d.ts

@@ -0,0 +1,3 @@
+export * from './cities.getters';
+export type { City, CityDoc } from './cities.types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/municipal/cities/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/municipal/cities/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./cities.getters"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/municipal/cities/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAAiC"}

package/dist/municipal/departmentsSubjects/departmentsSubjects.getters.d.ts

@@ -0,0 +1,62 @@
+import { DepartmentSubject } from '../index';
+import { Collection, Filter } from 'mongodb';
+import { CityName, VectorSearchResult } from './departmentsSubjects.types';
+export declare const getDepartmentsSubjectsCollection: () => Collection<DepartmentSubject>;
+/**
+ * Get all departments subjects for a given city.
+ * No DB sort; tree build does not depend on order. Callers that need alphabetical order
+ * sort in memory (e.g. sortTreeAlphabetically in full-tree-subjects.service).
+ * @param cityName - City name to filter subjects
+ * @param withEmbeddings - Whether to include embedding and embedding_model fields (default: false)
+ * @returns Array of all department subjects for the city
+ */
+export declare const getAllDepartmentsSubjectsByCity: (cityName: CityName, withEmbeddings?: boolean) => Promise<DepartmentSubject[]>;
+/**
+ * Perform vector search on departmentsSubjects collection
+ * @param queryVector - The embedding vector to search with
+ * @param cityName - City name to filter results
+ * @param limit - Maximum number of results (default: 5)
+ * @param numCandidates - Number of candidates to consider (default: 800)
+ * @returns Array of vector search results
+ */
+export declare const vectorSearchDepartmentsSubjects: (queryVector: number[], cityName: CityName, limit?: number, numCandidates?: number) => Promise<VectorSearchResult[]>;
+export declare const addDepartmentSubjectInstruction: (filter: Filter<DepartmentSubject>, instructionText: string) => Promise<DepartmentSubject | null>;
+export declare const updateDepartmentSubjectInstruction: (filter: Filter<DepartmentSubject>, instructionId: number, newInstructionText: string) => Promise<DepartmentSubject | null>;
+export declare const removeDepartmentSubjectInstruction: (filter: Filter<DepartmentSubject>, instructionId: number) => Promise<DepartmentSubject | null>;
+export declare const addDepartmentSubjectCommunication: (filter: Filter<DepartmentSubject>, communication: {
+    type: "free_text_sms" | "upload_url_sms";
+    message_text?: string;
+    template_id?: string;
+    to?: string;
+}) => Promise<DepartmentSubject | null>;
+export declare const updateDepartmentSubjectCommunication: (filter: Filter<DepartmentSubject>, communicationId: number, updates: {
+    type?: "free_text_sms" | "upload_url_sms";
+    message_text?: string | null;
+    template_id?: string | null;
+    to?: string | null;
+    is_deleted?: boolean | null;
+}) => Promise<DepartmentSubject | null>;
+export declare const removeDepartmentSubjectCommunication: (filter: Filter<DepartmentSubject>, communicationId: number) => Promise<DepartmentSubject | null>;
+/**
+ * Get department subject by subject_id, sub_subject_id, and cityName
+ * @param subjectId - Subject ID (from event_subject_id)
+ * @param subSubjectId - Sub-subject ID (from event_sub_subject_id, optional)
+ * @param cityName - City name to filter results
+ * @returns DepartmentSubject document or null if not found
+ */
+export declare const getDepartmentSubjectBySubjectIds: (subjectId: string, subSubjectId: string, cityName: CityName) => Promise<DepartmentSubject | null>;
+/**
+ * Update or create guidelines field for a department subject
+ * @param filter - MongoDB filter to find the document
+ * @param guidelines - Guidelines text to set
+ * @returns Updated DepartmentSubject document or null if not found
+ */
+export declare const updateDepartmentSubjectGuidelines: (filter: Filter<DepartmentSubject>, guidelines: string) => Promise<DepartmentSubject | null>;
+/**
+ * Clear guidelines field from a department subject document (sets it to null)
+ * @param filter - MongoDB filter to find the document
+ * @returns Updated DepartmentSubject document or null if not found
+ */
+export declare const deleteDepartmentSubjectGuidelines: (filter: Filter<DepartmentSubject>) => Promise<DepartmentSubject | null>;
+export declare const findSubjectByQuery: (query: Partial<DepartmentSubject>) => Promise<import("mongodb").WithId<DepartmentSubject> | null>;
+//# sourceMappingURL=departmentsSubjects.getters.d.ts.map

package/dist/municipal/departmentsSubjects/departmentsSubjects.getters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"departmentsSubjects.getters.d.ts","sourceRoot":"","sources":["../../../src/municipal/departmentsSubjects/departmentsSubjects.getters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,iBAAiB,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAE3E,eAAO,MAAM,gCAAgC,QAAO,UAAU,CAAC,iBAAiB,CAE/E,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,+BAA+B,GAC1C,UAAU,QAAQ,EAClB,iBAAgB,OAAe,KAC9B,OAAO,CAAC,iBAAiB,EAAE,CAW7B,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,+BAA+B,GAC1C,aAAa,MAAM,EAAE,EACrB,UAAU,QAAQ,EAClB,QAAO,MAAU,EACjB,gBAAe,MAAY,KAC1B,OAAO,CAAC,kBAAkB,EAAE,CAgC9B,CAAC;AAEF,eAAO,MAAM,+BAA+B,GAC1C,QAAQ,MAAM,CAAC,iBAAiB,CAAC,EACjC,iBAAiB,MAAM,KACtB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAgBlC,CAAC;AAEF,eAAO,MAAM,kCAAkC,GAC7C,QAAQ,MAAM,CAAC,iBAAiB,CAAC,EACjC,eAAe,MAAM,EACrB,oBAAoB,MAAM,KACzB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAQlC,CAAC;AAEF,eAAO,MAAM,kCAAkC,GAC7C,QAAQ,MAAM,CAAC,iBAAiB,CAAC,EACjC,eAAe,MAAM,KACpB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAWlC,CAAC;AAEF,eAAO,MAAM,iCAAiC,GAC5C,QAAQ,MAAM,CAAC,iBAAiB,CAAC,EACjC,eAAe;IACb,IAAI,EAAE,eAAe,GAAG,gBAAgB,CAAC;IACzC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,KACA,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAoBlC,CAAC;AAEF,eAAO,MAAM,oCAAoC,GAC/C,QAAQ,MAAM,CAAC,iBAAiB,CAAC,EACjC,iBAAiB,MAAM,EACvB,SAAS;IACP,IAAI,CAAC,EAAE,eAAe,GAAG,gBAAgB,CAAC;IAC1C,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAC7B,KACA,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAkBlC,CAAC;AAEF,eAAO,MAAM,oCAAoC,GAC/C,QAAQ,MAAM,CAAC,iBAAiB,CAAC,EACjC,iBAAiB,MAAM,KACtB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAWlC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gCAAgC,GAC3C,WAAW,MAAM,EACjB,cAAc,MAAM,EACpB,UAAU,QAAQ,KACjB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAelC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iCAAiC,GAC5C,QAAQ,MAAM,CAAC,iBAAiB,CAAC,EACjC,YAAY,MAAM,KACjB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAQlC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,GAC5C,QAAQ,MAAM,CAAC,iBAAiB,CAAC,KAChC,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAQlC,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAU,OAAO,OAAO,CAAC,iBAAiB,CAAC,gEAEzE,CAAC"}