@tmlmobilidade/interfaces 20260720.2249.10 → 20260723.1350.16

package/dist/common/index.d.ts

@@ -1,4 +1,3 @@
 export * from './aggregation-pipeline.js';
 export * from './enrich-user-refs.js';
 export * from './mongo-collection.js';
-export * from './mongo-transaction.js';

package/dist/common/index.js

@@ -1,4 +1,3 @@
 export * from './aggregation-pipeline.js';
 export * from './enrich-user-refs.js';
 export * from './mongo-collection.js';
-export * from './mongo-transaction.js';

package/dist/interfaces/index.d.ts

@@ -1,16 +1,8 @@
-export * from './alerts/index.js';
-export * from './file-exports/index.js';
-export * from './files/index.js';
-export * from './gtfs-validations/index.js';
 export * from './locations/index.js';
 export * from './metrics/index.js';
 export * from './notifications/index.js';
-export * from './pcgidb/index.js';
-export * from './plans/index.js';
 export * from './proposed-changes/index.js';
 export * from './rides/index.js';
 export * from './sams/index.js';
 export * from './simplified-apex/index.js';
-export * from './stops/index.js';
 export * from './vehicle-events/index.js';
-export * from './vehicles/index.js';

package/dist/interfaces/index.js

@@ -1,16 +1,8 @@
-export * from './alerts/index.js';
-export * from './file-exports/index.js';
-export * from './files/index.js';
-export * from './gtfs-validations/index.js';
 export * from './locations/index.js';
 export * from './metrics/index.js';
 export * from './notifications/index.js';
-export * from './pcgidb/index.js';
-export * from './plans/index.js';
 export * from './proposed-changes/index.js';
 export * from './rides/index.js';
 export * from './sams/index.js';
 export * from './simplified-apex/index.js';
-export * from './stops/index.js';
 export * from './vehicle-events/index.js';
-export * from './vehicles/index.js';

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

@@ -1,6 +1 @@
-export * from './hashed-patterns.js';
-export * from './hashed-shapes.js';
-export * from './hashed-trips.js';
 export * from './pipelines.js';
-export * from './ride-acceptances.js';
-export * from './rides.js';

package/dist/interfaces/rides/index.js

@@ -1,6 +1 @@
-export * from './hashed-patterns.js';
-export * from './hashed-shapes.js';
-export * from './hashed-trips.js';
 export * from './pipelines.js';
-export * from './ride-acceptances.js';
-export * from './rides.js';

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

@@ -101,7 +101,7 @@ type RidesPipelineFilter = OneOrTheOther<DatesRange, OperationalDateRange> & {
     seen_statuses?: SeenStatus[];
     stop_ids?: string[];
     ticketing_status?: TicketingStatus[];
-    vehicle_ids?: number[];
+    vehicle_ids?: string[];
 };
 /**
  * Creates MongoDB aggregation pipeline stages to filter and process ride data.

package/dist/interfaces/rides/pipelines.js

@@ -368,8 +368,8 @@ function buildSearchPipeline(filter) {
     if (vehicleMatch) {
         const vehicleIDs = vehicleMatch[1]
             .split(',')
-            .map(id => Number(id.trim()))
-            .filter(id => !isNaN(id));
+            .map(id => id.trim())
+            .filter(Boolean);
         if (vehicleIDs.length > 0) {
             pipeline.push({ $match: { vehicle_ids: { $in: vehicleIDs } } });
         }
@@ -420,7 +420,7 @@ export function ridesBatchAggregationPipeline({ ...filter }) {
     pipeline.push({ $sort: { start_time_scheduled: 1 } });
     // 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)) } } });
+        pipeline.push({ $match: { line_id: { $in: filter.line_ids } } });
     // 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)

package/dist/interfaces/simplified-apex/index.d.ts

@@ -1,5 +1,3 @@
-export * from './simplified-apex-inspection-decisions.js';
-export * from './simplified-apex-inspections.js';
 export * from './simplified-apex-locations.js';
 export * from './simplified-apex-on-board-refunds.js';
 export * from './simplified-apex-on-board-sales.js';

package/dist/interfaces/simplified-apex/index.js

@@ -1,5 +1,3 @@
-export * from './simplified-apex-inspection-decisions.js';
-export * from './simplified-apex-inspections.js';
 export * from './simplified-apex-locations.js';
 export * from './simplified-apex-on-board-refunds.js';
 export * from './simplified-apex-on-board-sales.js';

package/dist/interfaces/vehicle-events/simplified-vehicle-events.d.ts

@@ -1,5 +1,5 @@
 import { MongoCollectionClass } from '../../common/mongo-collection.js';
-import { type SimplifiedVehicleEvent } from '@tmlmobilidade/types';
+import { type SimplifiedVehicleEvent } from '@tmlmobilidade/go-types-vehicle-events';
 import { type IndexDescription } from 'mongodb';
 declare class SimplifiedVehicleEventsClass extends MongoCollectionClass<SimplifiedVehicleEvent, SimplifiedVehicleEvent, SimplifiedVehicleEvent> {
     private static _instance;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@tmlmobilidade/interfaces",
-	"version": "20260720.2249.10",
+	"version": "20260723.1350.16",
 	"author": {
 		"email": "iso@tmlmobilidade.pt",
 		"name": "TML-ISO"
@@ -37,10 +37,11 @@
 	},
 	"dependencies": {
 		"@tmlmobilidade/consts": "*",
-		"@tmlmobilidade/databases": "*",
 		"@tmlmobilidade/dates": "*",
 		"@tmlmobilidade/files": "*",
 		"@tmlmobilidade/go-interfaces-godb": "*",
+		"@tmlmobilidade/go-types-apex": "*",
+		"@tmlmobilidade/go-types-vehicle-events": "*",
 		"@tmlmobilidade/logger": "*",
 		"@tmlmobilidade/mongo": "*",
 		"@tmlmobilidade/ssh": "*",

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

@@ -1,25 +0,0 @@
-/**
- * NOTE: TRANSACTIONS ARE ONLY SUPPORTED BY REPLICA SETS
- *
- * Transaction numbers are only allowed on a replica set member or mongos
- *
- * @see https://www.mongodb.com/docs/manual/core/transactions-operations/
- */
-import { MongoConnector } from '@tmlmobilidade/mongo';
-import { ClientSession } from 'mongodb';
-import { MongoCollectionClass } from './mongo-collection.js';
-export declare class Transaction {
-    private mongoConnector;
-    private session;
-    constructor(mongoConnector: MongoConnector);
-    abort(): Promise<void>;
-    commit(): Promise<void>;
-    getSession(): ClientSession;
-    start(): Promise<void>;
-}
-export declare class TransactionManager<T extends readonly MongoCollectionClass<any, any, any>[]> {
-    private collections;
-    private transactions;
-    constructor(collections: T);
-    withTransaction<R>(callback: (collections: T, transactions: Map<MongoCollectionClass<any, any, any>, Transaction>) => Promise<R>): Promise<R>;
-}

package/dist/common/mongo-transaction.js

@@ -1,61 +0,0 @@
-/**
- * NOTE: TRANSACTIONS ARE ONLY SUPPORTED BY REPLICA SETS
- *
- * Transaction numbers are only allowed on a replica set member or mongos
- *
- * @see https://www.mongodb.com/docs/manual/core/transactions-operations/
- */
-export class Transaction {
-    mongoConnector;
-    session;
-    constructor(mongoConnector) {
-        this.mongoConnector = mongoConnector;
-    }
-    async abort() {
-        await this.session.abortTransaction();
-        await this.session.endSession();
-    }
-    async commit() {
-        await this.session.commitTransaction();
-        await this.session.endSession();
-    }
-    getSession() {
-        return this.session;
-    }
-    async start() {
-        this.session = (await this.mongoConnector).client.startSession();
-        this.session.startTransaction();
-    }
-}
-export class TransactionManager {
-    collections;
-    transactions = new Map();
-    constructor(collections) {
-        this.collections = collections;
-    }
-    async withTransaction(callback) {
-        try {
-            // Start transactions for each collection
-            for (const collection of this.collections) {
-                const transaction = new Transaction(collection.getMongoConnector());
-                await transaction.start();
-                this.transactions.set(collection, transaction);
-            }
-            // Execute callback with collections and transaction map
-            const result = await callback(this.collections, this.transactions);
-            // If successful, commit all transactions
-            await Promise.all(Array.from(this.transactions.values()).map(transaction => transaction.commit()));
-            return result;
-        }
-        catch (error) {
-            // If any error occurs, abort all transactions
-            for (const transaction of this.transactions.values()) {
-                await transaction.abort();
-            }
-            throw error;
-        }
-        finally {
-            this.transactions.clear();
-        }
-    }
-}

package/dist/interfaces/alerts/alerts.d.ts

@@ -1,124 +0,0 @@
-import { MongoCollectionClass } from '../../common/mongo-collection.js';
-import { type Alert, type CreateAlertDto, type UpdateAlertDto } from '@tmlmobilidade/types';
-import { IndexDescription } from 'mongodb';
-import { z } from 'zod';
-declare class AlertsClass extends MongoCollectionClass<Alert, CreateAlertDto, UpdateAlertDto> {
-    private static _instance;
-    protected createSchema: z.ZodSchema;
-    protected updateSchema: z.ZodSchema;
-    private constructor();
-    static getInstance(): Promise<AlertsClass>;
-    findByExternalId(external_id: string): Promise<import("mongodb").WithId<{
-        _id: string;
-        created_at: number & {
-            __brand: "UnixTimestamp";
-        };
-        created_by: string | null;
-        is_locked: boolean;
-        updated_at: number & {
-            __brand: "UnixTimestamp";
-        };
-        description: string;
-        active_period_end_date: import("@tmlmobilidade/types").UnixTimestamp | null;
-        active_period_start_date: number & {
-            __brand: "UnixTimestamp";
-        };
-        agency_id: string;
-        auto_texts: boolean;
-        cause: "ACCIDENT" | "CONSTRUCTION" | "DEMONSTRATION" | "MEDICAL_EMERGENCY" | "POLICE_ACTIVITY" | "STRIKE" | "TECHNICAL_ISSUE" | "WEATHER" | "ABUSIVE_PARKING" | "DRIVER_ABSENCE" | "DRIVER_ISSUE" | "HIGH_PASSENGER_LOAD" | "NETWORK_UPDATE" | "ROAD_ISSUE" | "TRAFFIC_JAM" | "PUBLIC_DISORDER" | "VEHICLE_ISSUE";
-        coordinates: [number, number] | null;
-        effect: "ACCESSIBILITY_ISSUE" | "ADDITIONAL_SERVICE" | "DETOUR" | "MODIFIED_SERVICE" | "NO_SERVICE" | "REDUCED_SERVICE" | "SIGNIFICANT_DELAYS" | "STOP_MOVED" | "REALTIME_INFO_ISSUE" | "ON_BOARD_SALE_ISSUE";
-        external_id: string | null;
-        file_id: string | null;
-        info_url: string | null;
-        municipality_ids: string[];
-        publish_end_date: import("@tmlmobilidade/types").UnixTimestamp | null;
-        publish_start_date: import("@tmlmobilidade/types").UnixTimestamp | null;
-        publish_status: "published" | "archived" | "draft";
-        reference_type: "agency" | "lines" | "stops" | "rides";
-        references: {
-            child_ids: string[];
-            parent_id: string;
-        }[];
-        title: string;
-        user_instructions: string;
-        updated_by?: string | undefined;
-    }>>;
-    findByMunicipalityId(municipality_id: string): Promise<import("mongodb").WithId<{
-        _id: string;
-        created_at: number & {
-            __brand: "UnixTimestamp";
-        };
-        created_by: string | null;
-        is_locked: boolean;
-        updated_at: number & {
-            __brand: "UnixTimestamp";
-        };
-        description: string;
-        active_period_end_date: import("@tmlmobilidade/types").UnixTimestamp | null;
-        active_period_start_date: number & {
-            __brand: "UnixTimestamp";
-        };
-        agency_id: string;
-        auto_texts: boolean;
-        cause: "ACCIDENT" | "CONSTRUCTION" | "DEMONSTRATION" | "MEDICAL_EMERGENCY" | "POLICE_ACTIVITY" | "STRIKE" | "TECHNICAL_ISSUE" | "WEATHER" | "ABUSIVE_PARKING" | "DRIVER_ABSENCE" | "DRIVER_ISSUE" | "HIGH_PASSENGER_LOAD" | "NETWORK_UPDATE" | "ROAD_ISSUE" | "TRAFFIC_JAM" | "PUBLIC_DISORDER" | "VEHICLE_ISSUE";
-        coordinates: [number, number] | null;
-        effect: "ACCESSIBILITY_ISSUE" | "ADDITIONAL_SERVICE" | "DETOUR" | "MODIFIED_SERVICE" | "NO_SERVICE" | "REDUCED_SERVICE" | "SIGNIFICANT_DELAYS" | "STOP_MOVED" | "REALTIME_INFO_ISSUE" | "ON_BOARD_SALE_ISSUE";
-        external_id: string | null;
-        file_id: string | null;
-        info_url: string | null;
-        municipality_ids: string[];
-        publish_end_date: import("@tmlmobilidade/types").UnixTimestamp | null;
-        publish_start_date: import("@tmlmobilidade/types").UnixTimestamp | null;
-        publish_status: "published" | "archived" | "draft";
-        reference_type: "agency" | "lines" | "stops" | "rides";
-        references: {
-            child_ids: string[];
-            parent_id: string;
-        }[];
-        title: string;
-        user_instructions: string;
-        updated_by?: string | undefined;
-    }>[]>;
-    findByTitle(title: string): Promise<import("mongodb").WithId<{
-        _id: string;
-        created_at: number & {
-            __brand: "UnixTimestamp";
-        };
-        created_by: string | null;
-        is_locked: boolean;
-        updated_at: number & {
-            __brand: "UnixTimestamp";
-        };
-        description: string;
-        active_period_end_date: import("@tmlmobilidade/types").UnixTimestamp | null;
-        active_period_start_date: number & {
-            __brand: "UnixTimestamp";
-        };
-        agency_id: string;
-        auto_texts: boolean;
-        cause: "ACCIDENT" | "CONSTRUCTION" | "DEMONSTRATION" | "MEDICAL_EMERGENCY" | "POLICE_ACTIVITY" | "STRIKE" | "TECHNICAL_ISSUE" | "WEATHER" | "ABUSIVE_PARKING" | "DRIVER_ABSENCE" | "DRIVER_ISSUE" | "HIGH_PASSENGER_LOAD" | "NETWORK_UPDATE" | "ROAD_ISSUE" | "TRAFFIC_JAM" | "PUBLIC_DISORDER" | "VEHICLE_ISSUE";
-        coordinates: [number, number] | null;
-        effect: "ACCESSIBILITY_ISSUE" | "ADDITIONAL_SERVICE" | "DETOUR" | "MODIFIED_SERVICE" | "NO_SERVICE" | "REDUCED_SERVICE" | "SIGNIFICANT_DELAYS" | "STOP_MOVED" | "REALTIME_INFO_ISSUE" | "ON_BOARD_SALE_ISSUE";
-        external_id: string | null;
-        file_id: string | null;
-        info_url: string | null;
-        municipality_ids: string[];
-        publish_end_date: import("@tmlmobilidade/types").UnixTimestamp | null;
-        publish_start_date: import("@tmlmobilidade/types").UnixTimestamp | null;
-        publish_status: "published" | "archived" | "draft";
-        reference_type: "agency" | "lines" | "stops" | "rides";
-        references: {
-            child_ids: string[];
-            parent_id: string;
-        }[];
-        title: string;
-        user_instructions: string;
-        updated_by?: string | undefined;
-    }>>;
-    protected getCollectionIndexes(): IndexDescription[];
-    protected getCollectionName(): string;
-    protected getEnvName(): string;
-}
-export declare const alerts: AlertsClass;
-export {};

package/dist/interfaces/alerts/alerts.js

@@ -1,50 +0,0 @@
-/* * */
-import { MongoCollectionClass } from '../../common/mongo-collection.js';
-import { CreateAlertSchema, UpdateAlertSchema } from '@tmlmobilidade/types';
-import { asyncSingletonProxy } from '@tmlmobilidade/utils';
-/* * */
-class AlertsClass extends MongoCollectionClass {
-    static _instance;
-    createSchema = CreateAlertSchema;
-    updateSchema = UpdateAlertSchema;
-    constructor() {
-        super();
-    }
-    static async getInstance() {
-        if (!AlertsClass._instance) {
-            const instance = new AlertsClass();
-            await instance.connect();
-            AlertsClass._instance = instance;
-        }
-        return AlertsClass._instance;
-    }
-    async findByExternalId(external_id) {
-        return this.mongoCollection.findOne({ external_id });
-    }
-    async findByMunicipalityId(municipality_id) {
-        return this.mongoCollection.find({ municipality_ids: { $in: [municipality_id] } }).toArray();
-    }
-    async findByTitle(title) {
-        return this.mongoCollection.findOne({ title });
-    }
-    getCollectionIndexes() {
-        return [
-            { background: true, key: { agency_ids: 1 } },
-            { background: true, key: { line_ids: 1 } },
-            { background: true, key: { municipality_ids: 1 } },
-            { background: true, key: { route_ids: 1 } },
-            { background: true, key: { stop_ids: 1 } },
-            { background: true, key: { title: 1 } },
-            { background: true, key: { active_period_end_date: -1, active_period_start_date: -1 } },
-            { background: true, key: { publish_end_date: -1, publish_start_date: -1 } },
-        ];
-    }
-    getCollectionName() {
-        return 'alerts';
-    }
-    getEnvName() {
-        return 'DATABASE_URI';
-    }
-}
-/* * */
-export const alerts = asyncSingletonProxy(AlertsClass);

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

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

package/dist/interfaces/alerts/index.js

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

package/dist/interfaces/file-exports/file-exports.d.ts

@@ -1,20 +0,0 @@
-import { MongoCollectionClass } from '../../common/mongo-collection.js';
-import { CreateFileExportDto, FileExport } from '@tmlmobilidade/types';
-import { IndexDescription } from 'mongodb';
-import { z } from 'zod';
-declare class FileExportsClass extends MongoCollectionClass<FileExport, CreateFileExportDto<any>, Partial<FileExport>> {
-    private static _instance;
-    protected createSchema: z.ZodSchema;
-    protected updateSchema: z.ZodSchema;
-    private constructor();
-    static getInstance(): Promise<FileExportsClass>;
-    protected getCollectionIndexes(): IndexDescription[];
-    protected getCollectionName(): string;
-    protected getEnvName(): string;
-}
-/**
- * @deprecated This class is deprecated and will be removed in the future.
- * Use `@tmlmobilidade/go-interfaces-godb` instead.
- */
-export declare const fileExports: FileExportsClass;
-export {};

package/dist/interfaces/file-exports/file-exports.js

@@ -1,47 +0,0 @@
-/* eslint-disable @typescript-eslint/no-explicit-any */
-/* * */
-import { MongoCollectionClass } from '../../common/mongo-collection.js';
-import { CreateFileExportSchema, UpdateFileExportSchema } from '@tmlmobilidade/types';
-import { asyncSingletonProxy } from '@tmlmobilidade/utils';
-/* * */
-class FileExportsClass extends MongoCollectionClass {
-    //
-    //
-    //
-    static _instance;
-    createSchema = CreateFileExportSchema;
-    updateSchema = UpdateFileExportSchema;
-    constructor() {
-        super();
-    }
-    static async getInstance() {
-        if (!FileExportsClass._instance) {
-            const instance = new FileExportsClass();
-            await instance.connect();
-            FileExportsClass._instance = instance;
-        }
-        return FileExportsClass._instance;
-    }
-    getCollectionIndexes() {
-        return [
-            { background: true, key: { file_name: 1 } },
-            { background: true, key: { processing_status: 1 } },
-            { background: true, key: { scope: 1 } },
-            { background: true, key: { type: 1 } },
-            { background: true, expireAfterSeconds: 60_000 * 4 * 60, key: { created_at: 1 } }, // 4 hours
-            { background: true, key: { updated_at: 1 } },
-        ];
-    }
-    getCollectionName() {
-        return 'exports';
-    }
-    getEnvName() {
-        return 'DATABASE_URI';
-    }
-}
-/* * */
-/**
- * @deprecated This class is deprecated and will be removed in the future.
- * Use `@tmlmobilidade/go-interfaces-godb` instead.
- */
-export const fileExports = asyncSingletonProxy(FileExportsClass);

package/dist/interfaces/file-exports/index.d.ts

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

package/dist/interfaces/file-exports/index.js

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

package/dist/interfaces/files/files.d.ts

@@ -1,63 +0,0 @@
-import { MongoCollectionClass } from '../../common/mongo-collection.js';
-import { type CreateFileDto, type File, type UpdateFileDto } from '@tmlmobilidade/types';
-import { DeleteOptions, DeleteResult, FindOptions, IndexDescription, InsertOneOptions, WithId } from 'mongodb';
-import { Readable } from 'node:stream';
-import { z } from 'zod';
-declare class FilesClass extends MongoCollectionClass<File, CreateFileDto, UpdateFileDto> {
-    private static _instance;
-    protected createSchema: z.ZodSchema;
-    protected updateSchema: z.ZodSchema;
-    private readonly bucketName;
-    private readonly storageService;
-    private constructor();
-    static getInstance(): Promise<FilesClass>;
-    /**
-     * Clones a file from one resource to another.
-     * @param fileId - The unique identifier of the file in the database.
-     * @param resourceId - The unique identifier of the resource to clone the file to.
-     * @returns The file that was cloned.
-     */
-    clone(fileId: string, scope: string, resourceId: string, options?: InsertOneOptions): Promise<File>;
-    /**
-     * Deletes a file from the storage service and the database.
-     * @param fileId - The unique identifier of the file in the database.
-     * @returns The file that was deleted.
-     */
-    deleteById(fileId: string, options?: DeleteOptions): Promise<DeleteResult>;
-    /**
-     * Retrieves a file from the database and adds the signed URL to the file object.
-     * @param file_id - The unique identifier of the file in the database.
-     * @returns The file with the signed URL.
-     */
-    findById(id: string, options?: FindOptions): Promise<null | WithId<File>>;
-    /**
-     * Retrieves the signed URL of a file from the storage service.
-     * @param params - Object containing either `file_id` or `key`.
-     * @param params.file_id - The unique identifier of the file in the database.
-     * @param params.key - The storage key of the file.
-     * @param options - Optional options.
-     * @returns The signed URL of the file.
-     * @throws {Error} If neither `file_id` nor `key` is provided.
-     * @throws {HttpException} If `file_id` is provided but the file is not found.
-    */
-    getFileUrl({ file_id, key }: {
-        file_id?: string;
-        key?: string;
-    }, options?: FindOptions): Promise<string>;
-    /**
-     * Uploads a file to the storage service and inserts it into the database.
-     * @param file - The file to upload, either as a string, buffer, or readable stream.
-     * @param createFileDto - The file type to create.
-     * @returns The file that was uploaded.
-     */
-    upload(file: Buffer | Readable | ReadableStream | string, createFileDto: CreateFileDto & {
-        _id?: string;
-    }, options?: InsertOneOptions & {
-        override?: boolean;
-    }): Promise<File>;
-    protected getCollectionIndexes(): IndexDescription[];
-    protected getCollectionName(): string;
-    protected getEnvName(): string;
-}
-export declare const files: FilesClass;
-export {};