@talkpilot/core-db 1.2.2 → 1.3.0

package/README_OLD.md

@@ -1,160 +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.
-
+# @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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"}

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

@@ -1,5 +1,4 @@
 import { CityName, Ticket } from "../index";
-import type { SubjectStatsItem } from "./tickets.types";
 import { Collection, Filter, ObjectId as MongoObjectId } from "mongodb";
 /**
  * Generate a new ticket ID as a string
@@ -13,16 +12,6 @@ export declare const getTicketById: (ticketId: string) => Promise<Ticket | null>
 export declare const createTicket: (ticketData: Omit<Ticket, "_id" | "createdAt" | "updatedAt">, ticketId?: string) => Promise<MongoObjectId>;
 export declare const updateTicket: (ticketId: string, data: Partial<Omit<Ticket, "_id" | "createdAt" | "updatedAt">>) => Promise<Ticket | null>;
 export declare const deleteTicket: (ticketId: string) => Promise<boolean>;
-/**
- * Count tickets by city and date range (createdAt converted to given timezone).
- * Used as "open" tickets count when status is not available.
- */
-export declare function getTicketsCountByCityAndDateRange(cityName: string, startStr: string, endStr: string, timezone: string): Promise<number>;
-/**
- * Count of tickets by department (subject) from departmentsSubjects. Different departments (subject_id) are grouped, and sub-subjects are unified under their department.
- * Date filter: createdAt in [startStr, endStr] (in the given timezone). Fallback to "Unclassified" when no match is found in the lookup.
- */
-export declare function getTicketsSubjectStats(cityName: string, startStr: string, endStr: string, timezone: string): Promise<SubjectStatsItem[]>;
 export declare const findTicketByQuery: (query: Partial<Ticket>) => Promise<import("mongodb").WithId<Ticket> | null>;
 /**
  * Update ticket files by external call number

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

@@ -1 +1 @@
-{"version":3,"file":"tickets.getters.d.ts","sourceRoot":"","sources":["../../../src/municipal/tickets/tickets.getters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAmB,MAAM,EAAE,MAAM,UAAU,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,IAAI,aAAa,EAAE,MAAM,SAAS,CAAC;AAExE;;;GAGG;AACH,eAAO,MAAM,gBAAgB,QAAO,MAEnC,CAAC;AAEF,eAAO,MAAM,oBAAoB,QAAO,UAAU,CAAC,MAAM,CAExD,CAAC;AAEF,eAAO,MAAM,WAAW,GACtB,SAAQ,MAAM,CAAC,MAAM,CAAM,KAC1B,OAAO,CAAC,MAAM,EAAE,CAElB,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAC/B,SAAS,MAAM,KACd,OAAO,CAAC,MAAM,EAAE,CAElB,CAAC;AAEF,eAAO,MAAM,aAAa,GACxB,UAAU,MAAM,KACf,OAAO,CAAC,MAAM,GAAG,IAAI,CAKvB,CAAC;AAEF,eAAO,MAAM,YAAY,GACvB,YAAY,IAAI,CAAC,MAAM,EAAE,KAAK,GAAG,WAAW,GAAG,WAAW,CAAC,EAC3D,WAAW,MAAM,KAChB,OAAO,CAAC,aAAa,CASvB,CAAC;AAEF,eAAO,MAAM,YAAY,GACvB,UAAU,MAAM,EAChB,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,GAAG,WAAW,GAAG,WAAW,CAAC,CAAC,KAC7D,OAAO,CAAC,MAAM,GAAG,IAAI,CAOvB,CAAC;AAEF,eAAO,MAAM,YAAY,GAAU,UAAU,MAAM,KAAG,OAAO,CAAC,OAAO,CAKpE,CAAC;AAEF;;;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,CAqG7B;AAED,eAAO,MAAM,iBAAiB,GAAU,OAAO,OAAO,CAAC,MAAM,CAAC,qDAE7D,CAAC;AACF;;GAEG;AACH,eAAO,MAAM,6BAA6B,GAAU,QAAQ;IAC1D,QAAQ,EAAE,QAAQ,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,KAAG,OAAO,CAAC,OAAO,CAsBlB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,GAAU,QAAQ;IACtD,QAAQ,EAAE,QAAQ,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB,KAAG,OAAO,CAAC,OAAO,CASlB,CAAC"}
+{"version":3,"file":"tickets.getters.d.ts","sourceRoot":"","sources":["../../../src/municipal/tickets/tickets.getters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAmB,MAAM,EAAE,MAAM,UAAU,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,IAAI,aAAa,EAAE,MAAM,SAAS,CAAC;AAExE;;;GAGG;AACH,eAAO,MAAM,gBAAgB,QAAO,MAEnC,CAAC;AAEF,eAAO,MAAM,oBAAoB,QAAO,UAAU,CAAC,MAAM,CAExD,CAAC;AAEF,eAAO,MAAM,WAAW,GACtB,SAAQ,MAAM,CAAC,MAAM,CAAM,KAC1B,OAAO,CAAC,MAAM,EAAE,CAElB,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAC/B,SAAS,MAAM,KACd,OAAO,CAAC,MAAM,EAAE,CAElB,CAAC;AAEF,eAAO,MAAM,aAAa,GACxB,UAAU,MAAM,KACf,OAAO,CAAC,MAAM,GAAG,IAAI,CAKvB,CAAC;AAEF,eAAO,MAAM,YAAY,GACvB,YAAY,IAAI,CAAC,MAAM,EAAE,KAAK,GAAG,WAAW,GAAG,WAAW,CAAC,EAC3D,WAAW,MAAM,KAChB,OAAO,CAAC,aAAa,CASvB,CAAC;AAEF,eAAO,MAAM,YAAY,GACvB,UAAU,MAAM,EAChB,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,GAAG,WAAW,GAAG,WAAW,CAAC,CAAC,KAC7D,OAAO,CAAC,MAAM,GAAG,IAAI,CAOvB,CAAC;AAEF,eAAO,MAAM,YAAY,GAAU,UAAU,MAAM,KAAG,OAAO,CAAC,OAAO,CAKpE,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAU,OAAO,OAAO,CAAC,MAAM,CAAC,qDAE7D,CAAC;AACF;;GAEG;AACH,eAAO,MAAM,6BAA6B,GAAU,QAAQ;IAC1D,QAAQ,EAAE,QAAQ,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,KAAG,OAAO,CAAC,OAAO,CAsBlB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,GAAU,QAAQ;IACtD,QAAQ,EAAE,QAAQ,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB,KAAG,OAAO,CAAC,OAAO,CASlB,CAAC"}