@tmlmobilidade/interfaces 20260420.1828.16 → 20260423.1140.30

package/dist/common/mongo-collection.d.ts

@@ -68,7 +68,7 @@ export declare abstract class MongoCollectionClass<T extends Document, TCreate,
      * @param key The key to find distinct values for.
      * @returns A promise that resolves to an array of distinct values for the given key.
      */
-    distinct<Key extends keyof WithId<T>>(key: Key, filter: Filter<T>): Promise<Array<Flatten<WithId<T>[Key]>>>;
+    distinct<Key extends keyof WithId<T>>(key: Key, filter?: Filter<T>): Promise<Array<Flatten<WithId<T>[Key]>>>;
     /**
      * Checks if a document with the given key and value exists in the collection.
      * @param key The key to check for existence.

package/dist/common/mongo-collection.js

@@ -107,8 +107,13 @@ export class MongoCollectionClass {
     async disconnect() {
         await this.mongoConnector.disconnect();
     }
-    async distinct(key) {
-        return this.mongoCollection.distinct(key);
+    /**
+     * Finds all distinct values for a key in the collection.
+     * @param key The key to find distinct values for.
+     * @returns A promise that resolves to an array of distinct values for the given key.
+     */
+    async distinct(key, filter) {
+        return this.mongoCollection.distinct(key, filter);
     }
     /**
      * Checks if a document with the given key and value exists in the collection.

package/dist/interfaces/dates/events.d.ts

@@ -62,6 +62,13 @@ declare class EventsClass extends MongoCollectionClass<Event, CreateEventDto, Up
             lines_to_include?: string[] | undefined;
             same_weekday?: boolean | undefined;
         })[];
+        associated_patterns: {
+            _id: string;
+            code: string;
+            line_id: string;
+            headsign: string;
+            route_id: string;
+        }[];
         updated_by?: string | undefined;
     }>[]>;
     protected getCollectionIndexes(): IndexDescription[];

package/dist/interfaces/offer/patterns.d.ts

@@ -69,6 +69,8 @@ declare class PatternsClass extends MongoCollectionClass<Pattern, CreatePatternD
             lines_to_include?: string[] | undefined;
             same_weekday?: boolean | undefined;
         })[];
+        headsign: string;
+        route_id: string;
         comments: ({
             created_at: number & {
                 __brand: "UnixTimestamp";
@@ -115,8 +117,6 @@ declare class PatternsClass extends MongoCollectionClass<Pattern, CreatePatternD
             _id?: string | undefined;
             updated_by?: string | undefined;
         })[];
-        headsign: string;
-        route_id: string;
         destination: string;
         direction: "outbound" | "inbound";
         origin: string;

package/dist/interfaces/rides/pipelines.js

@@ -271,9 +271,13 @@ function routeTermToField(term) {
     if (/^\d+_\d+_\d+$/.test(term)) {
         return { pattern_id: term };
     }
-    // Exact trip_id match: "1001_0_2_0800_0829_0_26"
-    if (/^\d+_\d+_\d+_\d+_\d+_\d+_\d+$/.test(term)) {
-        return { trip_id: term };
+    // Wildcard trip_id: any string containing %%; %% → regex .*
+    // NOTE: case-sensitive (no $options: 'i') so anchored prefix regex can use
+    // the { trip_id: 1 } / { trip_id: 1, start_time_scheduled: 1 } index.
+    if (term.includes('%%')) {
+        let escaped = term.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        escaped = escaped.replace(/%%/g, '.*');
+        return { trip_id: { $regex: `^${escaped}$` } };
     }
     // route_id: "1001_0"
     if (/^\d+_\d+$/.test(term)) {
@@ -289,12 +293,6 @@ function routeTermToField(term) {
         const n = Number(term);
         if (term.length >= 3)
             return { line_id: n };
-        if (term.length <= 2)
-            return { agency_id: term };
-    }
-    // plan_id: uppercase alpha-numeric prefix like "KACZ2"
-    if (/^[A-Z]+\d*$/.test(term)) {
-        return { plan_id: term };
     }
     return null;
 }
@@ -331,10 +329,17 @@ function buildSearchPipeline(filter) {
             }
         }
         if (unroutableTerms.length > 0) {
-            const pattern = unroutableTerms
-                .map(k => `(?=.*${k.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')})`)
-                .join('') + '.*';
-            conditions.push({ _id: { $options: 'i', $regex: pattern } });
+            // Anchor first term as prefix on trip_id so the query can use the
+            // { trip_id: 1, start_time_scheduled: 1 } compound index.
+            // Remaining terms become plain contains-regex (no index, but bounded
+            // by the prefix scan of the first term).
+            // NOTE: case-sensitive; adding $options: 'i' disables index usage.
+            const escape = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+            const [firstTerm, ...restTerms] = unroutableTerms;
+            conditions.push({ trip_id: { $regex: `^${escape(firstTerm)}` } });
+            for (const rest of restTerms) {
+                conditions.push({ trip_id: { $regex: escape(rest) } });
+            }
         }
         if (conditions.length === 1) {
             pipeline.push({ $match: conditions[0] });

package/dist/interfaces/rides/rides.d.ts

@@ -28,10 +28,10 @@ declare class RidesClass extends MongoCollectionClass<Ride, CreateRideDto, Updat
         pattern_id: string;
         trip_id: string;
         seen_last_at: import("@tmlmobilidade/types").UnixTimestamp | null;
-        driver_ids: string[];
         headsign: string;
-        plan_id: string;
         route_id: string;
+        driver_ids: string[];
+        plan_id: string;
         vehicle_ids: number[];
         operational_date: string & {
             __brand: "OperationalDate";
@@ -177,10 +177,10 @@ declare class RidesClass extends MongoCollectionClass<Ride, CreateRideDto, Updat
         pattern_id: string;
         trip_id: string;
         seen_last_at: import("@tmlmobilidade/types").UnixTimestamp | null;
-        driver_ids: string[];
         headsign: string;
-        plan_id: string;
         route_id: string;
+        driver_ids: string[];
+        plan_id: string;
         vehicle_ids: number[];
         operational_date: string & {
             __brand: "OperationalDate";
@@ -326,10 +326,10 @@ declare class RidesClass extends MongoCollectionClass<Ride, CreateRideDto, Updat
         pattern_id: string;
         trip_id: string;
         seen_last_at: import("@tmlmobilidade/types").UnixTimestamp | null;
-        driver_ids: string[];
         headsign: string;
-        plan_id: string;
         route_id: string;
+        driver_ids: string[];
+        plan_id: string;
         vehicle_ids: number[];
         operational_date: string & {
             __brand: "OperationalDate";
@@ -475,10 +475,10 @@ declare class RidesClass extends MongoCollectionClass<Ride, CreateRideDto, Updat
         pattern_id: string;
         trip_id: string;
         seen_last_at: import("@tmlmobilidade/types").UnixTimestamp | null;
-        driver_ids: string[];
         headsign: string;
-        plan_id: string;
         route_id: string;
+        driver_ids: string[];
+        plan_id: string;
         vehicle_ids: number[];
         operational_date: string & {
             __brand: "OperationalDate";
@@ -624,10 +624,10 @@ declare class RidesClass extends MongoCollectionClass<Ride, CreateRideDto, Updat
         pattern_id: string;
         trip_id: string;
         seen_last_at: import("@tmlmobilidade/types").UnixTimestamp | null;
-        driver_ids: string[];
         headsign: string;
-        plan_id: string;
         route_id: string;
+        driver_ids: string[];
+        plan_id: string;
         vehicle_ids: number[];
         operational_date: string & {
             __brand: "OperationalDate";
@@ -773,10 +773,10 @@ declare class RidesClass extends MongoCollectionClass<Ride, CreateRideDto, Updat
         pattern_id: string;
         trip_id: string;
         seen_last_at: import("@tmlmobilidade/types").UnixTimestamp | null;
-        driver_ids: string[];
         headsign: string;
-        plan_id: string;
         route_id: string;
+        driver_ids: string[];
+        plan_id: string;
         vehicle_ids: number[];
         operational_date: string & {
             __brand: "OperationalDate";

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@tmlmobilidade/interfaces",
-	"version": "20260420.1828.16",
+	"version": "20260423.1140.30",
 	"author": {
 		"email": "iso@tmlmobilidade.pt",
 		"name": "TML-ISO"