@tmlmobilidade/interfaces 20251217.1540.37 → 20251218.110.37

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

@@ -0,0 +1,38 @@
+import { MongoCollectionClass } from '../../common/mongo-collection.js';
+import { type Annotation, type CreateAnnotationDto, type UpdateAnnotationDto } from '@tmlmobilidade/types';
+import { IndexDescription } from 'mongodb';
+import { z } from 'zod';
+declare class AnnotationsClass extends MongoCollectionClass<Annotation, CreateAnnotationDto, UpdateAnnotationDto> {
+    private static _instance;
+    protected createSchema: z.ZodSchema;
+    protected updateSchema: z.ZodSchema;
+    private constructor();
+    static getInstance(): Promise<AnnotationsClass>;
+    /**
+     * Finds Annotation documents by agency IDs.
+     *
+     * @param ids - The agency IDs to search for
+     * @returns A promise that resolves to an array of matching documents
+     */
+    findByAgencyIds(ids: string[]): Promise<import("mongodb").WithId<{
+        _id: string;
+        created_at: number & {
+            __brand: "UnixTimestamp";
+        };
+        is_locked: boolean;
+        updated_at: number & {
+            __brand: "UnixTimestamp";
+        };
+        title: string;
+        agency_ids: string[];
+        dates: import("@tmlmobilidade/types").OperationalDate[];
+        created_by?: string | undefined;
+        updated_by?: string | undefined;
+        description?: string | undefined;
+    }>[]>;
+    protected getCollectionIndexes(): IndexDescription[];
+    protected getCollectionName(): string;
+    protected getEnvName(): string;
+}
+export declare const annotations: AnnotationsClass;
+export {};

package/dist/interfaces/dates/annotations.js

@@ -0,0 +1,41 @@
+/* * */
+import { MongoCollectionClass } from '../../common/mongo-collection.js';
+import { AnnotationSchema, UpdateAnnotationSchema } from '@tmlmobilidade/types';
+import { AsyncSingletonProxy } from '@tmlmobilidade/utils';
+/* * */
+class AnnotationsClass extends MongoCollectionClass {
+    static _instance;
+    createSchema = AnnotationSchema;
+    updateSchema = UpdateAnnotationSchema;
+    constructor() {
+        super();
+    }
+    static async getInstance() {
+        if (!AnnotationsClass._instance) {
+            const instance = new AnnotationsClass();
+            await instance.connect();
+            AnnotationsClass._instance = instance;
+        }
+        return AnnotationsClass._instance;
+    }
+    /**
+     * Finds Annotation documents by agency IDs.
+     *
+     * @param ids - The agency IDs to search for
+     * @returns A promise that resolves to an array of matching documents
+     */
+    async findByAgencyIds(ids) {
+        return this.mongoCollection.find({ agency_ids: { $in: ids } }).toArray();
+    }
+    getCollectionIndexes() {
+        return [];
+    }
+    getCollectionName() {
+        return 'annotations';
+    }
+    getEnvName() {
+        return 'DATABASE_URI';
+    }
+}
+/* * */
+export const annotations = AsyncSingletonProxy(AnnotationsClass);

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

@@ -0,0 +1 @@
+export * from './annotations.js';

package/dist/interfaces/dates/index.js

@@ -0,0 +1 @@
+export * from './annotations.js';

package/dist/interfaces/gtfs-validations/gtfs-validations.d.ts

@@ -19,6 +19,7 @@ declare class GtfValidationsClass extends MongoCollectionClass<GtfsValidation, C
         created_at: number & {
             __brand: "UnixTimestamp";
         };
+        is_locked: boolean;
         updated_at: number & {
             __brand: "UnixTimestamp";
         };

package/dist/interfaces/index.d.ts

@@ -1,6 +1,7 @@
 export * from './agencies/index.js';
 export * from './alerts/index.js';
 export * from './auth/index.js';
+export * from './dates/index.js';
 export * from './file-exports/index.js';
 export * from './files/index.js';
 export * from './gtfs-validations/index.js';

package/dist/interfaces/index.js

@@ -1,6 +1,7 @@
 export * from './agencies/index.js';
 export * from './alerts/index.js';
 export * from './auth/index.js';
+export * from './dates/index.js';
 export * from './file-exports/index.js';
 export * from './files/index.js';
 export * from './gtfs-validations/index.js';

package/dist/interfaces/locations/locations.js

@@ -105,7 +105,7 @@ class LocationsClass {
         const locality = await this.findLocalitiesByGeo(lat, lon, { projection: { _id: 1, properties: 1 } });
         const _census = census ? await this.findCensusByGeo(lat, lon, { projection: { _id: 1, properties: 1 } }) : undefined;
         return {
-            census: { ..._census.properties, _id: _census._id },
+            census: { ..._census?.properties, _id: _census?._id },
             district: district,
             latitude: lat,
             locality: locality,
@@ -159,7 +159,7 @@ class LocationsClass {
         } : undefined;
         return {
             _id: doc._id,
-            ...doc.properties,
+            ...doc?.properties,
             geojson,
         };
     }

package/dist/interfaces/organizations/organizations.js

@@ -1,11 +1,11 @@
 /* * */
 import { MongoCollectionClass } from '../../common/mongo-collection.js';
-import { CreateOrganizationSchema, OrganizationSchema, UpdateOrganizationSchema } from '@tmlmobilidade/types';
+import { OrganizationSchema, UpdateOrganizationSchema } from '@tmlmobilidade/types';
 import { AsyncSingletonProxy } from '@tmlmobilidade/utils';
 /* * */
 class OrganizationsClass extends MongoCollectionClass {
     static _instance;
-    createSchema = CreateOrganizationSchema;
+    createSchema = OrganizationSchema;
     updateSchema = UpdateOrganizationSchema;
     constructor() {
         super();

package/dist/interfaces/pcgidb/pcgidb-legacy.js

@@ -24,7 +24,6 @@ class PCGIDBLegacyClass {
         // Get the database URI from environment variables
         const mongoClientOptions = {
             connectTimeoutMS: 10_000,
-            // directConnection: true,
             maxPoolSize: 20,
             minPoolSize: 2,
             readPreference: 'secondaryPreferred',

package/dist/interfaces/pcgidb/pcgidb-ticketing.js

@@ -21,7 +21,6 @@ class PCGIDBTicketingClass {
         // Get the database URI from environment variables
         const mongoClientOptions = {
             connectTimeoutMS: 10_000,
-            // directConnection: true,
             maxPoolSize: 20,
             minPoolSize: 2,
             readPreference: 'secondaryPreferred',

package/dist/interfaces/pcgidb/pcgidb-validations.js

@@ -22,7 +22,6 @@ class PCGIDBValidationsClass {
         // Get the database URI from environment variables
         const mongoClientOptions = {
             connectTimeoutMS: 10_000,
-            // directConnection: true,
             maxPoolSize: 20,
             minPoolSize: 2,
             readPreference: 'secondaryPreferred',

package/dist/interfaces/plans/plans.d.ts

@@ -19,10 +19,10 @@ declare class PlansClass extends MongoCollectionClass<Plan, CreatePlanDto, Updat
         created_at: number & {
             __brand: "UnixTimestamp";
         };
+        is_locked: boolean;
         updated_at: number & {
             __brand: "UnixTimestamp";
         };
-        is_locked: boolean;
         gtfs_agency: {
             agency_id: string;
             agency_name: string;

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

@@ -26,6 +26,7 @@ declare class RidesClass extends MongoCollectionClass<Ride, CreateRideDto, Updat
         line_id: number;
         pattern_id: string;
         trip_id: string;
+        seen_last_at: import("@tmlmobilidade/types").UnixTimestamp | null;
         driver_ids: string[];
         headsign: string;
         plan_id: string;
@@ -45,7 +46,6 @@ declare class RidesClass extends MongoCollectionClass<Ride, CreateRideDto, Updat
         extension_observed: number | null;
         extension_scheduled: number;
         seen_first_at: import("@tmlmobilidade/types").UnixTimestamp | null;
-        seen_last_at: import("@tmlmobilidade/types").UnixTimestamp | null;
         passengers_estimated: number | null;
         passengers_observed: number | null;
         passengers_observed_on_board_sales_amount: number | null;
@@ -175,6 +175,7 @@ declare class RidesClass extends MongoCollectionClass<Ride, CreateRideDto, Updat
         line_id: number;
         pattern_id: string;
         trip_id: string;
+        seen_last_at: import("@tmlmobilidade/types").UnixTimestamp | null;
         driver_ids: string[];
         headsign: string;
         plan_id: string;
@@ -194,7 +195,6 @@ declare class RidesClass extends MongoCollectionClass<Ride, CreateRideDto, Updat
         extension_observed: number | null;
         extension_scheduled: number;
         seen_first_at: import("@tmlmobilidade/types").UnixTimestamp | null;
-        seen_last_at: import("@tmlmobilidade/types").UnixTimestamp | null;
         passengers_estimated: number | null;
         passengers_observed: number | null;
         passengers_observed_on_board_sales_amount: number | null;
@@ -324,6 +324,7 @@ declare class RidesClass extends MongoCollectionClass<Ride, CreateRideDto, Updat
         line_id: number;
         pattern_id: string;
         trip_id: string;
+        seen_last_at: import("@tmlmobilidade/types").UnixTimestamp | null;
         driver_ids: string[];
         headsign: string;
         plan_id: string;
@@ -343,7 +344,6 @@ declare class RidesClass extends MongoCollectionClass<Ride, CreateRideDto, Updat
         extension_observed: number | null;
         extension_scheduled: number;
         seen_first_at: import("@tmlmobilidade/types").UnixTimestamp | null;
-        seen_last_at: import("@tmlmobilidade/types").UnixTimestamp | null;
         passengers_estimated: number | null;
         passengers_observed: number | null;
         passengers_observed_on_board_sales_amount: number | null;
@@ -473,6 +473,7 @@ declare class RidesClass extends MongoCollectionClass<Ride, CreateRideDto, Updat
         line_id: number;
         pattern_id: string;
         trip_id: string;
+        seen_last_at: import("@tmlmobilidade/types").UnixTimestamp | null;
         driver_ids: string[];
         headsign: string;
         plan_id: string;
@@ -492,7 +493,6 @@ declare class RidesClass extends MongoCollectionClass<Ride, CreateRideDto, Updat
         extension_observed: number | null;
         extension_scheduled: number;
         seen_first_at: import("@tmlmobilidade/types").UnixTimestamp | null;
-        seen_last_at: import("@tmlmobilidade/types").UnixTimestamp | null;
         passengers_estimated: number | null;
         passengers_observed: number | null;
         passengers_observed_on_board_sales_amount: number | null;
@@ -622,6 +622,7 @@ declare class RidesClass extends MongoCollectionClass<Ride, CreateRideDto, Updat
         line_id: number;
         pattern_id: string;
         trip_id: string;
+        seen_last_at: import("@tmlmobilidade/types").UnixTimestamp | null;
         driver_ids: string[];
         headsign: string;
         plan_id: string;
@@ -641,7 +642,6 @@ declare class RidesClass extends MongoCollectionClass<Ride, CreateRideDto, Updat
         extension_observed: number | null;
         extension_scheduled: number;
         seen_first_at: import("@tmlmobilidade/types").UnixTimestamp | null;
-        seen_last_at: import("@tmlmobilidade/types").UnixTimestamp | null;
         passengers_estimated: number | null;
         passengers_observed: number | null;
         passengers_observed_on_board_sales_amount: number | null;
@@ -771,6 +771,7 @@ declare class RidesClass extends MongoCollectionClass<Ride, CreateRideDto, Updat
         line_id: number;
         pattern_id: string;
         trip_id: string;
+        seen_last_at: import("@tmlmobilidade/types").UnixTimestamp | null;
         driver_ids: string[];
         headsign: string;
         plan_id: string;
@@ -790,7 +791,6 @@ declare class RidesClass extends MongoCollectionClass<Ride, CreateRideDto, Updat
         extension_observed: number | null;
         extension_scheduled: number;
         seen_first_at: import("@tmlmobilidade/types").UnixTimestamp | null;
-        seen_last_at: import("@tmlmobilidade/types").UnixTimestamp | null;
         passengers_estimated: number | null;
         passengers_observed: number | null;
         passengers_observed_on_board_sales_amount: number | null;

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

@@ -1,6 +1,6 @@
 import { MongoCollectionClass } from '../../common/mongo-collection.js';
 import { type CreateStopDto, type Stop, type UpdateStopDto } from '@tmlmobilidade/types';
-import { type IndexDescription, type Sort } from 'mongodb';
+import { type DeleteResult, type IndexDescription, type Sort } from 'mongodb';
 import { z } from 'zod';
 declare class StopsClass extends MongoCollectionClass<Stop, CreateStopDto, UpdateStopDto> {
     private static _instance;
@@ -8,13 +8,26 @@ declare class StopsClass extends MongoCollectionClass<Stop, CreateStopDto, Updat
     protected updateSchema: z.ZodSchema;
     private constructor();
     static getInstance(): Promise<StopsClass>;
+    /**
+     * Override deleteById to prevent actual deletion of stop documents.
+     * Stops cannot be deleted, only archived.
+     * @param filter The filter used to select the document to "delete".
+     * @returns A promise that rejects with an error indicating deletion is not allowed.
+     */
+    deleteById(): Promise<DeleteResult>;
+    /**
+     * Override deleteOne to prevent actual deletion of stop documents.
+     * Stops cannot be deleted, only archived.
+     * @param filter The filter used to select the document to "delete".
+     * @returns A promise that rejects with an error indicating deletion is not allowed.
+     */
+    deleteOne(): Promise<DeleteResult>;
     /**
      * Finds stop documents by municipality ID with optional pagination and sorting.
-     *
-     * @param id - The municipality ID to search for
-     * @param perPage - Optional number of documents per page for pagination
-     * @param page - Optional page number for pagination
-     * @param sort - Optional sort specification
+     * @param id The municipality ID to search for
+     * @param perPage Optional number of documents per page for pagination
+     * @param page Optional page number for pagination
+     * @param sort Optional sort specification
      * @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<{
@@ -22,10 +35,12 @@ declare class StopsClass extends MongoCollectionClass<Stop, CreateStopDto, Updat
         created_at: number & {
             __brand: "UnixTimestamp";
         };
+        is_locked: boolean;
         updated_at: number & {
             __brand: "UnixTimestamp";
         };
         name: string;
+        short_name: string;
         comments: ({
             created_at: number & {
                 __brand: "UnixTimestamp";
@@ -66,54 +81,51 @@ declare class StopsClass extends MongoCollectionClass<Stop, CreateStopDto, Updat
             created_by?: string | undefined;
             updated_by?: string | undefined;
         })[];
-        is_locked: boolean;
-        has_bench: "unknown" | "yes" | "no";
-        has_network_map: "unknown" | "yes" | "no";
-        has_schedules: "unknown" | "yes" | "no";
-        has_shelter: "unknown" | "yes" | "no";
-        has_stop_sign: "unknown" | "yes" | "no";
+        has_bench: "unknown" | "available" | "unavailable";
+        has_network_map: "unknown" | "available" | "unavailable";
+        has_schedules: "unknown" | "available" | "unavailable";
+        has_shelter: "unknown" | "available" | "unavailable";
+        has_stop_sign: "unknown" | "available" | "unavailable";
         municipality_id: string;
-        is_archived: boolean;
+        parish_id: string | null;
+        shelter_code: string | null;
+        shelter_maintainer: string | null;
+        is_deleted: boolean;
         jurisdiction: "unknown" | "ip" | "municipality" | "other";
-        lifecycle_status: "active" | "inactive" | "provisional" | "seasonal" | "voided";
+        legacy_id: string | null;
+        lifecycle_status: "draft" | "active" | "inactive" | "provisional" | "seasonal" | "voided";
+        new_name: string | null;
+        tts_name: string;
         district_id: string;
         latitude: number;
+        locality_id: string | null;
         longitude: number;
         bench_status: "unknown" | "not_applicable" | "missing" | "damaged" | "ok";
         electricity_status: "unknown" | "available" | "unavailable";
         pole_status: "unknown" | "not_applicable" | "missing" | "damaged" | "ok";
         road_type: "unknown" | "complementary_itinerary" | "highway" | "main_itinerary" | "national_road" | "regional_road" | "secondary_road";
+        shelter_frame_size: [number, number] | null;
+        shelter_installation_date: import("@tmlmobilidade/types").UnixTimestamp | null;
+        shelter_make: string | null;
+        shelter_model: string | null;
         shelter_status: "unknown" | "not_applicable" | "missing" | "damaged" | "ok";
+        last_infrastructure_check: import("@tmlmobilidade/types").UnixTimestamp | null;
+        last_infrastructure_maintenance: import("@tmlmobilidade/types").UnixTimestamp | null;
+        last_schedules_check: import("@tmlmobilidade/types").UnixTimestamp | null;
+        last_schedules_maintenance: import("@tmlmobilidade/types").UnixTimestamp | null;
         connections: ("ferry" | "light_rail" | "subway" | "train" | "boat" | "airport" | "bike_sharing" | "bike_parking" | "car_parking")[];
         facilities: ("school" | "fire_station" | "health_clinic" | "historic_building" | "hospital" | "police_station" | "shopping" | "transit_office" | "university" | "beach")[];
         equipment: ("pip" | "mupi" | "mini_pip")[];
-        has_mupi: "unknown" | "yes" | "no";
+        has_mupi: "unknown" | "available" | "unavailable";
         file_ids: string[];
         image_ids: string[];
+        observations: string | null;
         created_by?: string | undefined;
         updated_by?: string | undefined;
-        short_name?: string | null | undefined;
-        parish_id?: string | null | undefined;
-        shelter_code?: string | null | undefined;
-        shelter_maintainer?: string | null | undefined;
-        legacy_id?: string | null | undefined;
-        new_name?: string | null | undefined;
-        tts_name?: string | null | undefined;
-        locality_id?: string | null | undefined;
-        shelter_frame_size?: [number, number] | null | undefined;
-        shelter_installation_date?: import("@tmlmobilidade/types").UnixTimestamp | null | undefined;
-        shelter_make?: string | null | undefined;
-        shelter_model?: string | null | undefined;
-        last_infrastructure_check?: import("@tmlmobilidade/types").UnixTimestamp | null | undefined;
-        last_infrastructure_maintenance?: import("@tmlmobilidade/types").UnixTimestamp | null | undefined;
-        last_schedules_check?: import("@tmlmobilidade/types").UnixTimestamp | null | undefined;
-        last_schedules_maintenance?: import("@tmlmobilidade/types").UnixTimestamp | null | undefined;
-        observations?: string | null | undefined;
     }>[]>;
     /**
      * Finds multiple stop documents by their IDs.
-     *
-     * @param ids - Array of stop IDs to search for
+     * @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<{
@@ -121,10 +133,12 @@ declare class StopsClass extends MongoCollectionClass<Stop, CreateStopDto, Updat
         created_at: number & {
             __brand: "UnixTimestamp";
         };
+        is_locked: boolean;
         updated_at: number & {
             __brand: "UnixTimestamp";
         };
         name: string;
+        short_name: string;
         comments: ({
             created_at: number & {
                 __brand: "UnixTimestamp";
@@ -165,50 +179,57 @@ declare class StopsClass extends MongoCollectionClass<Stop, CreateStopDto, Updat
             created_by?: string | undefined;
             updated_by?: string | undefined;
         })[];
-        is_locked: boolean;
-        has_bench: "unknown" | "yes" | "no";
-        has_network_map: "unknown" | "yes" | "no";
-        has_schedules: "unknown" | "yes" | "no";
-        has_shelter: "unknown" | "yes" | "no";
-        has_stop_sign: "unknown" | "yes" | "no";
+        has_bench: "unknown" | "available" | "unavailable";
+        has_network_map: "unknown" | "available" | "unavailable";
+        has_schedules: "unknown" | "available" | "unavailable";
+        has_shelter: "unknown" | "available" | "unavailable";
+        has_stop_sign: "unknown" | "available" | "unavailable";
         municipality_id: string;
-        is_archived: boolean;
+        parish_id: string | null;
+        shelter_code: string | null;
+        shelter_maintainer: string | null;
+        is_deleted: boolean;
         jurisdiction: "unknown" | "ip" | "municipality" | "other";
-        lifecycle_status: "active" | "inactive" | "provisional" | "seasonal" | "voided";
+        legacy_id: string | null;
+        lifecycle_status: "draft" | "active" | "inactive" | "provisional" | "seasonal" | "voided";
+        new_name: string | null;
+        tts_name: string;
         district_id: string;
         latitude: number;
+        locality_id: string | null;
         longitude: number;
         bench_status: "unknown" | "not_applicable" | "missing" | "damaged" | "ok";
         electricity_status: "unknown" | "available" | "unavailable";
         pole_status: "unknown" | "not_applicable" | "missing" | "damaged" | "ok";
         road_type: "unknown" | "complementary_itinerary" | "highway" | "main_itinerary" | "national_road" | "regional_road" | "secondary_road";
+        shelter_frame_size: [number, number] | null;
+        shelter_installation_date: import("@tmlmobilidade/types").UnixTimestamp | null;
+        shelter_make: string | null;
+        shelter_model: string | null;
         shelter_status: "unknown" | "not_applicable" | "missing" | "damaged" | "ok";
+        last_infrastructure_check: import("@tmlmobilidade/types").UnixTimestamp | null;
+        last_infrastructure_maintenance: import("@tmlmobilidade/types").UnixTimestamp | null;
+        last_schedules_check: import("@tmlmobilidade/types").UnixTimestamp | null;
+        last_schedules_maintenance: import("@tmlmobilidade/types").UnixTimestamp | null;
         connections: ("ferry" | "light_rail" | "subway" | "train" | "boat" | "airport" | "bike_sharing" | "bike_parking" | "car_parking")[];
         facilities: ("school" | "fire_station" | "health_clinic" | "historic_building" | "hospital" | "police_station" | "shopping" | "transit_office" | "university" | "beach")[];
         equipment: ("pip" | "mupi" | "mini_pip")[];
-        has_mupi: "unknown" | "yes" | "no";
+        has_mupi: "unknown" | "available" | "unavailable";
         file_ids: string[];
         image_ids: string[];
+        observations: string | null;
         created_by?: string | undefined;
         updated_by?: string | undefined;
-        short_name?: string | null | undefined;
-        parish_id?: string | null | undefined;
-        shelter_code?: string | null | undefined;
-        shelter_maintainer?: string | null | undefined;
-        legacy_id?: string | null | undefined;
-        new_name?: string | null | undefined;
-        tts_name?: string | null | undefined;
-        locality_id?: string | null | undefined;
-        shelter_frame_size?: [number, number] | null | undefined;
-        shelter_installation_date?: import("@tmlmobilidade/types").UnixTimestamp | null | undefined;
-        shelter_make?: string | null | undefined;
-        shelter_model?: string | null | undefined;
-        last_infrastructure_check?: import("@tmlmobilidade/types").UnixTimestamp | null | undefined;
-        last_infrastructure_maintenance?: import("@tmlmobilidade/types").UnixTimestamp | null | undefined;
-        last_schedules_check?: import("@tmlmobilidade/types").UnixTimestamp | null | undefined;
-        last_schedules_maintenance?: import("@tmlmobilidade/types").UnixTimestamp | null | undefined;
-        observations?: string | null | undefined;
     }>[]>;
+    /**
+     * Toogle the delete status of a document by its ID.
+     * Stop documents are never truly deleted to preserve
+     * data integrity and prevent ID reuse.
+     * @param id The ID of the stop document to delete.
+     * @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>;
     protected getCollectionIndexes(): IndexDescription[];
     protected getCollectionName(): string;
     protected getEnvName(): string;

package/dist/interfaces/stops/stops.js

@@ -18,13 +18,30 @@ class StopsClass extends MongoCollectionClass {
         }
         return StopsClass._instance;
     }
+    /**
+     * Override deleteById to prevent actual deletion of stop documents.
+     * Stops cannot be deleted, only archived.
+     * @param filter The filter used to select the document to "delete".
+     * @returns A promise that rejects with an error indicating deletion is not allowed.
+     */
+    async deleteById() {
+        throw new Error('Method not implemented. Stops cannot be deleted, only archived.');
+    }
+    /**
+     * Override deleteOne to prevent actual deletion of stop documents.
+     * Stops cannot be deleted, only archived.
+     * @param filter The filter used to select the document to "delete".
+     * @returns A promise that rejects with an error indicating deletion is not allowed.
+     */
+    async deleteOne() {
+        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
-     * @param perPage - Optional number of documents per page for pagination
-     * @param page - Optional page number for pagination
-     * @param sort - Optional sort specification
+     * @param id The municipality ID to search for
+     * @param perPage Optional number of documents per page for pagination
+     * @param page Optional page number for pagination
+     * @param sort Optional sort specification
      * @returns A promise that resolves to an array of matching stop documents
      */
     async findByMunicipalityId(id, perPage, page, sort) {
@@ -39,13 +56,30 @@ class StopsClass extends MongoCollectionClass {
     }
     /**
      * Finds multiple stop documents by their IDs.
-     *
-     * @param ids - Array of stop IDs to search for
+     * @param ids Array of stop IDs to search for
      * @returns A promise that resolves to an array of matching stop documents
      */
     async findManyByIds(ids) {
         return this.mongoCollection.find({ _id: { $in: ids } }).toArray();
     }
+    /**
+     * Toogle the delete status of a document by its ID.
+     * Stop documents are never truly deleted to preserve
+     * data integrity and prevent ID reuse.
+     * @param id The ID of the stop document to delete.
+     * @param forceValue Optional boolean to explicitly set the deleted status.
+     * @returns A promise that resolves to the result of the delete operation.
+     */
+    async toggleDeleteById(id, forceValue) {
+        // Get the current document from the database
+        const foundDoc = await this.findById(id);
+        if (!foundDoc)
+            throw new Error('Stop not found');
+        // Determine the new deleted status
+        const newDeletedStatus = forceValue !== undefined ? forceValue : !foundDoc.is_deleted;
+        // If the document is deleted, we allow the operation even if it's locked
+        await this.updateById(id, { is_deleted: newDeletedStatus }, { forceIfLocked: !newDeletedStatus && foundDoc.is_locked });
+    }
     getCollectionIndexes() {
         return [
             { background: true, key: { name: 1 } },

package/dist/providers/auth/auth.js

@@ -112,7 +112,7 @@ class AuthProvider {
      */
     async login(loginDto) {
         // Find the user by email
-        const userData = await users.findByEmail(loginDto.email, true);
+        const userData = await users.findByEmail(loginDto.email, { includeUnsafeProperties: true });
         if (!userData)
             throw new HttpException(HttpStatus.UNAUTHORIZED, 'User not found');
         // Check if the password matches the stored hash

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@tmlmobilidade/interfaces",
-	"version": "20251217.1540.37",
+	"version": "20251218.110.37",
 	"author": {
 		"email": "iso@tmlmobilidade.pt",
 		"name": "TML-ISO"
@@ -53,7 +53,7 @@
 	"devDependencies": {
 		"@tmlmobilidade/tsconfig": "*",
 		"@tmlmobilidade/types": "*",
-		"@types/node": "25.0.1",
+		"@types/node": "25.0.3",
 		"resolve-tspaths": "0.8.23",
 		"tsc-watch": "7.2.0",
 		"typescript": "5.9.3"