@tmlmobilidade/interfaces 20260411.1248.30 → 20260418.1237.24

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

@@ -120,7 +120,7 @@ export declare abstract class MongoCollectionClass<T extends Document, TCreate,
      * @returns A promise that resolves to the result of the insert operation
      */
     insertMany(docs: (TCreate & {
-        _id?: string;
+        _id?: T['_id'];
         created_at?: UnixTimestamp;
         created_by?: string;
         updated_at?: UnixTimestamp;
@@ -136,7 +136,7 @@ export declare abstract class MongoCollectionClass<T extends Document, TCreate,
      * @returns A promise that resolves to the result of the insert operation.
      */
     insertOne<TReturnDocument extends boolean = true>(doc: TCreate & {
-        _id?: string;
+        _id?: T['_id'];
         created_at?: UnixTimestamp;
         created_by?: string;
         updated_at?: UnixTimestamp;

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

@@ -24,6 +24,7 @@ declare class EventsClass extends MongoCollectionClass<Event, CreateEventDto, Up
         updated_at: number & {
             __brand: "UnixTimestamp";
         };
+        code: string;
         description: string;
         title: string;
         agency_ids: string[];

package/dist/interfaces/dates/year-periods.d.ts

@@ -27,6 +27,7 @@ declare class YearPeriodsClass extends MongoCollectionClass<YearPeriod, CreateYe
         name: string;
         agency_ids: string[];
         updated_by?: string | undefined;
+        code?: string | undefined;
         color?: string | undefined;
         dates?: import("@tmlmobilidade/types").OperationalDate[] | undefined;
     }>[]>;

package/dist/interfaces/locations/locations.js

@@ -1,6 +1,6 @@
 /* eslint-disable @typescript-eslint/no-explicit-any */
 /* eslint-disable perfectionist/sort-classes */
-import { HttpException, HTTP_STATUS } from '@tmlmobilidade/consts';
+import { HTTP_STATUS, HttpException } from '@tmlmobilidade/consts';
 import { MongoConnector } from '@tmlmobilidade/mongo';
 import { asyncSingletonProxy } from '@tmlmobilidade/utils';
 /* * */

package/dist/interfaces/notifications/notifications.js

@@ -2,8 +2,7 @@
 import { MongoCollectionClass } from '../../common/mongo-collection.js';
 import { roles } from '../auth/roles.js';
 import { users } from '../auth/users.js';
-import { getAppConfig } from '@tmlmobilidade/consts';
-import { sendGenericNotificationEmail } from '@tmlmobilidade/emails';
+import { getModuleConfig } from '@tmlmobilidade/consts';
 import { CreateNotificationSchema, UpdateNotificationSchema } from '@tmlmobilidade/types';
 import { asyncSingletonProxy, mergeObjects } from '@tmlmobilidade/utils';
 /* * */
@@ -40,7 +39,7 @@ class NotificationsClass extends MongoCollectionClass {
             is_read: false,
             payload: {
                 body: description,
-                href: `${getAppConfig(scope, 'frontend_url')}/${scope}/${id}`,
+                href: `${getModuleConfig(scope, 'frontend_url')}/${scope}/${id}`,
                 icon: scope,
                 title,
             },
@@ -55,18 +54,18 @@ class NotificationsClass extends MongoCollectionClass {
             const canReceiveEmail = this.getNotificationPermission(permissions, topic);
             const newNotification = { ...baseNotification, user_id: recipient._id };
             const result = await notifications.insertOne(newNotification);
-            // Send email if permission allows
-            if (canReceiveEmail) {
-                await sendGenericNotificationEmail({
-                    data: {
-                        body: result.payload.body,
-                        notificationId: result._id,
-                        notificationUrl: result.payload.href ?? '',
-                        title: result.payload.title,
-                    },
-                    to: recipient.email,
-                });
-            }
+            // // Send email if permission allows
+            // if (canReceiveEmail) {
+            // 	await sendGenericNotificationEmail({
+            // 		data: {
+            // 			body: result.payload.body,
+            // 			notificationId: result._id,
+            // 			notificationUrl: result.payload.href ?? '',
+            // 			title: result.payload.title,
+            // 		},
+            // 		to: recipient.email,
+            // 	});
+            // }
         }
     }
     getCollectionIndexes() {

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

@@ -123,14 +123,14 @@ declare class PatternsClass extends MongoCollectionClass<Pattern, CreatePatternD
         updated_by?: string | undefined;
         path?: {
             _id: string;
-            stop_id: string;
+            stop_id: number;
             timepoint: boolean;
             allow_drop_off: boolean;
             allow_pickup: boolean;
             distance_delta: number | null;
             zones?: string[] | undefined;
             stop?: {
-                _id: string;
+                _id: number;
                 created_at: number & {
                     __brand: "UnixTimestamp";
                 };
@@ -200,11 +200,19 @@ declare class PatternsClass extends MongoCollectionClass<Pattern, CreatePatternD
                 parish_id: string | null;
                 shelter_code: string | null;
                 shelter_maintainer: string | null;
+                flags: {
+                    short_name: string;
+                    stop_id: string;
+                    agency_ids: string[];
+                    is_harmonized: boolean;
+                }[];
                 is_deleted: boolean;
                 jurisdiction: "unknown" | "municipality" | "ip" | "other";
                 legacy_id: string | null;
+                legacy_ids: string[];
                 lifecycle_status: "draft" | "active" | "inactive" | "provisional" | "seasonal" | "voided";
                 new_name: string | null;
+                previous_go_id: string | null;
                 tts_name: string;
                 district_id: string;
                 locality_id: string | null;
@@ -242,7 +250,7 @@ declare class PatternsClass extends MongoCollectionClass<Pattern, CreatePatternD
         } | undefined;
         parameters?: ({
             path: {
-                stop_id: string;
+                stop_id: number;
                 avg_speed: number;
                 dwell_time: number;
             }[];
@@ -252,7 +260,7 @@ declare class PatternsClass extends MongoCollectionClass<Pattern, CreatePatternD
             vehicle_type?: string | undefined;
         } | {
             path: {
-                stop_id: string;
+                stop_id: number;
                 avg_speed: number;
                 dwell_time: number;
             }[];

package/dist/interfaces/rides/pipelines.js

@@ -262,6 +262,107 @@ export function ridesPipelineSeenStatus({ filter } = {}) {
     }
     return pipeline;
 }
+/**
+ * Attempts to map search term to specific indexed field based on structural
+ * heuristics. Returns null when term does not match known pattern.
+ */
+function routeTermToField(term) {
+    // Exact pattern_id match: "1001_0_2"
+    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 };
+    }
+    // route_id: "1001_0"
+    if (/^\d+_\d+$/.test(term)) {
+        return { route_id: term };
+    }
+    // operational_date: "20240101"
+    if (/^\d{8}$/.test(term)) {
+        return { operational_date: term };
+    }
+    // line_id: pure integer string like "1001"
+    // agency_id also numeric, so use length heuristic
+    if (/^\d+$/.test(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;
+}
+function buildSearchPipeline(filter) {
+    const pipeline = [];
+    if (!filter.search)
+        return pipeline;
+    const vehicleMatch = filter.search.match(/v:([\d,]+)/);
+    const driverMatch = filter.search.match(/d:([\d,]+)/);
+    const rawSearch = filter.search
+        .replace(/v:[\d,]+/g, '')
+        .replace(/d:[\d,]+/g, '')
+        .trim();
+    if (rawSearch.length > 0) {
+        const terms = rawSearch
+            .split(/\s+/)
+            .filter(k => k.length > 0);
+        const conditions = [];
+        const unroutableTerms = [];
+        const routedFields = new Set();
+        for (const term of terms) {
+            const routed = routeTermToField(term);
+            if (routed) {
+                const [field] = Object.keys(routed);
+                if (routedFields.has(field)) {
+                    unroutableTerms.push(term);
+                    continue;
+                }
+                routedFields.add(field);
+                conditions.push(routed);
+            }
+            else {
+                unroutableTerms.push(term);
+            }
+        }
+        if (unroutableTerms.length > 0) {
+            const pattern = unroutableTerms
+                .map(k => `(?=.*${k.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')})`)
+                .join('') + '.*';
+            conditions.push({ _id: { $options: 'i', $regex: pattern } });
+        }
+        if (conditions.length === 1) {
+            pipeline.push({ $match: conditions[0] });
+        }
+        else if (conditions.length > 1) {
+            pipeline.push({ $match: { $and: conditions } });
+        }
+    }
+    if (vehicleMatch) {
+        const vehicleIDs = vehicleMatch[1]
+            .split(',')
+            .map(id => Number(id.trim()))
+            .filter(id => !isNaN(id));
+        if (vehicleIDs.length > 0) {
+            pipeline.push({ $match: { vehicle_ids: { $in: vehicleIDs } } });
+        }
+    }
+    if (driverMatch) {
+        const driverIDs = driverMatch[1]
+            .split(',')
+            .map(id => id.trim())
+            .filter(Boolean);
+        if (driverIDs.length > 0) {
+            pipeline.push({ $match: { driver_ids: { $in: driverIDs } } });
+        }
+    }
+    return pipeline;
+}
 /**
  * Creates MongoDB aggregation pipeline stages to filter and process ride data.
  *
@@ -288,51 +389,8 @@ export function ridesBatchAggregationPipeline({ ...filter }) {
     // Stage 3: Filter by line IDs if provided
     if (filter.line_ids?.length)
         pipeline.push({ $match: { line_id: { $in: filter.line_ids.map(id => Number(id)) } } });
-    // Stage 4: Search by ride ID if provided
-    // Uses regex pattern matching with case-insensitive option
-    // Also removes all vehicle IDs and driver IDs from the search string
-    // And adds a filter for the vehicle IDs if they are present in the search string (v:1117,1118)
-    // And adds a filter for the driver IDs if they are present in the search string (d:123,456)
-    if (filter.search) {
-        // Extract vehicle and driver IDs before stripping them from search
-        const vehicleMatch = filter.search.match(/v:([\d,]+)/);
-        const driverMatch = filter.search.match(/d:([\d,]+)/);
-        // Remove v: and d: patterns from search string for ride ID matching
-        const searchWithoutSpecialFilters = filter.search.replace(/v:[\d,]+/g, '').replace(/d:[\d,]+/g, '').trim();
-        const keywords = searchWithoutSpecialFilters
-            .split(/\s+/)
-            .filter(k => k.length > 0)
-            .map((v) => {
-            // Escape regex special chars EXCEPT %
-            let escaped = v.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-            // Convert SQL wildcards to regex
-            escaped = escaped.replace(/%%/g, '.*');
-            return escaped;
-        });
-        if (keywords.length > 0) {
-            const pattern = keywords.map(k => `(?=.*${k})`).join('') + '.*';
-            pipeline.push({
-                $match: { _id: { $options: 'i', $regex: pattern } },
-            });
-        }
-        if (vehicleMatch) {
-            const value = vehicleMatch[1];
-            const vehicleIDs = value
-                .split(',')
-                .map(id => Number(id.trim()))
-                .filter(id => !isNaN(id));
-            if (vehicleIDs.length > 0) {
-                pipeline.push({ $match: { vehicle_ids: { $in: vehicleIDs } } });
-            }
-        }
-        if (driverMatch) {
-            const value = driverMatch[1];
-            const driverIDs = value.split(',').map(id => id.trim()).filter(id => id);
-            if (driverIDs.length > 0) {
-                pipeline.push({ $match: { driver_ids: { $in: driverIDs } } });
-            }
-        }
-    }
+    // Stage 4: Search by term routing and selective fallback regex
+    pipeline.push(...buildSearchPipeline(filter));
     // Stage 5: Search by vehicle IDs from search field if provided (legacy support)
     // This allows filtering via search field with "v:1117" or "v:1117,1118" format
     // Remove literal 'v:' from the search string since it is breaking stuff

package/dist/interfaces/stops/stops.d.ts

@@ -22,6 +22,13 @@ declare class StopsClass extends MongoCollectionClass<Stop, CreateStopDto, Updat
      * @returns A promise that rejects with an error indicating deletion is not allowed.
      */
     deleteOne(): Promise<DeleteResult>;
+    /**
+     * Override deleteMany to prevent actual deletion of stop documents.
+     * Stops cannot be deleted, only archived.
+     * @param filter The filter used to select the documents to "delete".
+     * @returns A promise that rejects with an error indicating deletion is not allowed.
+     */
+    deleteMany(): Promise<DeleteResult>;
     /**
      * Finds stop documents by municipality ID with optional pagination and sorting.
      * @param id The municipality ID to search for
@@ -31,7 +38,7 @@ declare class StopsClass extends MongoCollectionClass<Stop, CreateStopDto, Updat
      * @returns A promise that resolves to an array of matching stop documents
      */
     findByMunicipalityId(id: string, perPage?: number, page?: number, sort?: Sort): Promise<import("mongodb").WithId<{
-        _id: string;
+        _id: number;
         created_at: number & {
             __brand: "UnixTimestamp";
         };
@@ -101,11 +108,19 @@ declare class StopsClass extends MongoCollectionClass<Stop, CreateStopDto, Updat
         parish_id: string | null;
         shelter_code: string | null;
         shelter_maintainer: string | null;
+        flags: {
+            short_name: string;
+            stop_id: string;
+            agency_ids: string[];
+            is_harmonized: boolean;
+        }[];
         is_deleted: boolean;
         jurisdiction: "unknown" | "municipality" | "ip" | "other";
         legacy_id: string | null;
+        legacy_ids: string[];
         lifecycle_status: "draft" | "active" | "inactive" | "provisional" | "seasonal" | "voided";
         new_name: string | null;
+        previous_go_id: string | null;
         tts_name: string;
         district_id: string;
         locality_id: string | null;
@@ -134,8 +149,8 @@ declare class StopsClass extends MongoCollectionClass<Stop, CreateStopDto, Updat
      * @param ids Array of stop IDs to search for
      * @returns A promise that resolves to an array of matching stop documents
      */
-    findManyByIds(ids: string[]): Promise<import("mongodb").WithId<{
-        _id: string;
+    findManyByIds(ids: number[]): Promise<import("mongodb").WithId<{
+        _id: number;
         created_at: number & {
             __brand: "UnixTimestamp";
         };
@@ -205,11 +220,19 @@ declare class StopsClass extends MongoCollectionClass<Stop, CreateStopDto, Updat
         parish_id: string | null;
         shelter_code: string | null;
         shelter_maintainer: string | null;
+        flags: {
+            short_name: string;
+            stop_id: string;
+            agency_ids: string[];
+            is_harmonized: boolean;
+        }[];
         is_deleted: boolean;
         jurisdiction: "unknown" | "municipality" | "ip" | "other";
         legacy_id: string | null;
+        legacy_ids: string[];
         lifecycle_status: "draft" | "active" | "inactive" | "provisional" | "seasonal" | "voided";
         new_name: string | null;
+        previous_go_id: string | null;
         tts_name: string;
         district_id: string;
         locality_id: string | null;
@@ -241,7 +264,7 @@ declare class StopsClass extends MongoCollectionClass<Stop, CreateStopDto, Updat
      * @param forceValue Optional boolean to explicitly set the deleted status.
      * @returns A promise that resolves to the result of the delete operation.
      */
-    toggleDeleteById(id: string, forceValue?: boolean): Promise<void>;
+    toggleDeleteById(id: number, forceValue?: boolean): Promise<void>;
     protected getCollectionIndexes(): IndexDescription[];
     protected getCollectionName(): string;
     protected getEnvName(): string;

package/dist/interfaces/stops/stops.js

@@ -36,6 +36,15 @@ class StopsClass extends MongoCollectionClass {
     async deleteOne() {
         throw new Error('Method not implemented. Stops cannot be deleted, only archived.');
     }
+    /**
+     * Override deleteMany to prevent actual deletion of stop documents.
+     * Stops cannot be deleted, only archived.
+     * @param filter The filter used to select the documents to "delete".
+     * @returns A promise that rejects with an error indicating deletion is not allowed.
+     */
+    async deleteMany() {
+        throw new Error('Method not implemented. Stops cannot be deleted, only archived.');
+    }
     /**
      * Finds stop documents by municipality ID with optional pagination and sorting.
      * @param id The municipality ID to search for

package/dist/providers/auth/auth.d.ts

@@ -53,7 +53,7 @@ declare class AuthProvider {
      * @throws An HTTP error code:
      *   - INTERNAL_SERVER_ERROR if user creation fails
      */
-    register(createUserDto: CreateUserDto): Promise<void>;
+    register(createUserDto: CreateUserDto): Promise<string>;
 }
 export declare const authProvider: AuthProvider;
 export {};

package/dist/providers/auth/auth.js

@@ -1,8 +1,7 @@
 /* * */
 import { organizations, roles, sessions, users, verificationTokens } from '../../interfaces/index.js';
-import { HTTP_STATUS, HttpException, PAGE_ROUTES } from '@tmlmobilidade/consts';
+import { HTTP_STATUS, HttpException } from '@tmlmobilidade/consts';
 import { Dates } from '@tmlmobilidade/dates';
-import { sendWelcomeEmail } from '@tmlmobilidade/emails';
 import { generateRandomString, generateRandomToken } from '@tmlmobilidade/strings';
 import { asyncSingletonProxy, mergeObjects } from '@tmlmobilidade/utils';
 import bcrypt from 'bcryptjs';
@@ -159,14 +158,7 @@ class AuthProvider {
             token: verificationToken,
             user_id: insertNewUserResult._id,
         });
-        // Send a welcome email to the user with the verification token
-        await sendWelcomeEmail({
-            data: {
-                firstName: createUserDto.first_name,
-                resetPasswordUrl: `${PAGE_ROUTES.auth.CHANGE_PASSWORD_LIST}?token=${verificationToken}&email=${encodeURIComponent(createUserDto.email)}`,
-            },
-            to: createUserDto.email,
-        });
+        return verificationToken;
     }
 }
 /* * */

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@tmlmobilidade/interfaces",
-	"version": "20260411.1248.30",
+	"version": "20260418.1237.24",
 	"author": {
 		"email": "iso@tmlmobilidade.pt",
 		"name": "TML-ISO"
@@ -39,7 +39,6 @@
 		"@tmlmobilidade/consts": "*",
 		"@tmlmobilidade/databases": "*",
 		"@tmlmobilidade/dates": "*",
-		"@tmlmobilidade/emails": "*",
 		"@tmlmobilidade/files": "*",
 		"@tmlmobilidade/logger": "*",
 		"@tmlmobilidade/mongo": "*",
@@ -49,14 +48,14 @@
 		"@tmlmobilidade/writers": "*",
 		"bcryptjs": "3.0.3",
 		"mongodb": "7.1.1",
-		"oci-common": "2.127.0",
-		"oci-objectstorage": "2.127.0",
+		"oci-common": "2.129.0",
+		"oci-objectstorage": "2.129.0",
 		"zod": "3.25.76"
 	},
 	"devDependencies": {
 		"@tmlmobilidade/tsconfig": "*",
 		"@tmlmobilidade/types": "*",
-		"@types/node": "25.5.2",
+		"@types/node": "25.6.0",
 		"resolve-tspaths": "0.8.23",
 		"tsc-watch": "7.2.0",
 		"typescript": "5.9.3"