@tmlmobilidade/interfaces 20260720.2249.10 → 20260723.1350.16

package/dist/interfaces/files/files.js

@@ -1,198 +0,0 @@
-/* * */
-import { MongoCollectionClass } from '../../common/mongo-collection.js';
-import { StorageFactory } from '../../providers/index.js';
-import { HTTP_STATUS, HttpException } from '@tmlmobilidade/consts';
-import { Files } from '@tmlmobilidade/files';
-import { generateRandomString } from '@tmlmobilidade/strings';
-import { CreateFileSchema, UpdateFileSchema } from '@tmlmobilidade/types';
-import { asyncSingletonProxy, convertObject } from '@tmlmobilidade/utils';
-/* * */
-class FilesClass extends MongoCollectionClass {
-    //
-    static _instance;
-    createSchema = CreateFileSchema;
-    updateSchema = UpdateFileSchema;
-    bucketName;
-    storageService;
-    constructor() {
-        super();
-        switch (process.env.STORAGE_TYPE) {
-            case 'oci':
-                if (!process.env.OCI_PRIVATE_KEY && !process.env.OCI_PRIVATE_KEY_PATH) {
-                    throw new Error('Either OCI_PRIVATE_KEY or OCI_PRIVATE_KEY_PATH must be set');
-                }
-                if (!process.env.OCI_BUCKET_NAME || !process.env.OCI_FINGERPRINT || !process.env.OCI_NAMESPACE || !process.env.OCI_REGION || !process.env.OCI_TENANCY || !process.env.OCI_USER) {
-                    throw new Error('OCI_BUCKET_NAME, OCI_FINGERPRINT, OCI_NAMESPACE, OCI_REGION, OCI_TENANCY, and OCI_USER must be set');
-                }
-                this.bucketName = process.env.OCI_BUCKET_NAME;
-                this.storageService = StorageFactory.create({
-                    oci_config: {
-                        bucket_name: process.env.OCI_BUCKET_NAME,
-                        fingerprint: process.env.OCI_FINGERPRINT,
-                        namespace: process.env.OCI_NAMESPACE,
-                        private_key: process.env.OCI_PRIVATE_KEY,
-                        private_key_path: process.env.OCI_PRIVATE_KEY_PATH,
-                        region: process.env.OCI_REGION,
-                        tenancy: process.env.OCI_TENANCY,
-                        user: process.env.OCI_USER,
-                    },
-                    type: 'oci',
-                });
-                break;
-            default:
-                throw new Error(`Invalid storage type: ${process.env.STORAGE_TYPE}`);
-        }
-    }
-    static async getInstance() {
-        if (!FilesClass._instance) {
-            const instance = new FilesClass();
-            await instance.connect();
-            FilesClass._instance = instance;
-        }
-        return FilesClass._instance;
-    }
-    /**
-     * 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.
-     */
-    async clone(fileId, scope, resourceId, options) {
-        const _id = generateRandomString({ length: 5 });
-        const file = await this.findOne({ _id: fileId });
-        if (!file)
-            throw new HttpException(HTTP_STATUS.NOT_FOUND, 'File not found');
-        const originalFilePath = `${file.scope}/${file.resource_id}/${file._id}.${Files.getFileExtension(file.name)}`;
-        const newFilePath = `${scope}/${resourceId}/${_id}.${Files.getFileExtension(file.name)}`;
-        await this.storageService.copyFile(originalFilePath, newFilePath);
-        const newFile = convertObject(file, CreateFileSchema);
-        return await this.insertOne({ ...newFile, _id, resource_id: resourceId, scope }, { options });
-    }
-    /**
-     * 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.
-     */
-    async deleteById(fileId, options) {
-        const foundFile = await this.findById(fileId);
-        if (!foundFile)
-            throw new HttpException(HTTP_STATUS.NOT_FOUND, 'File not found');
-        await this.storageService.deleteFile(`${foundFile.scope}/${foundFile.resource_id}/${foundFile._id}.${Files.getFileExtensionFromMimeType(foundFile.type)}`);
-        return await super.deleteById(fileId, { ...options, forceIfLocked: true });
-    }
-    /**
-     * 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.
-     */
-    async findById(id, options) {
-        const file = await super.findById(id, options);
-        if (!file) {
-            return null;
-        }
-        file.url = await this.getFileUrl({ file_id: file._id }, options);
-        return 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.
-    */
-    async getFileUrl({ file_id, key }, options) {
-        if (!file_id && !key) {
-            throw new Error('Either "file_id" or "key" must be provided');
-        }
-        // If `file_id` is provided, fetch the file and use its key
-        let file = null;
-        if (file_id) {
-            file = await this.findOne({ _id: file_id }, options);
-            if (!file) {
-                throw new HttpException(HTTP_STATUS.NOT_FOUND, 'File not found');
-            }
-            key = `${file.scope}/${file.resource_id}/${file._id}.${Files.getFileExtension(file.name)}`; // Use the file's storage key
-        }
-        // Check if key exists
-        const keyExists = await this.storageService.fileExists(key);
-        if (!keyExists) {
-            throw new HttpException(HTTP_STATUS.NOT_FOUND, `Key ${key} does not exist in bucket ${this.bucketName}`);
-        }
-        // At this point, `key` must exist
-        return this.storageService.getFileUrl(key);
-    }
-    /**
-     * 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.
-     */
-    async upload(file, createFileDto, options) {
-        //
-        //
-        // A. Define variables
-        if (createFileDto._id && !options?.override) {
-            throw new HttpException(HTTP_STATUS.INTERNAL_SERVER_ERROR, 'When File ID is provided, override must be true');
-        }
-        const fileId = createFileDto._id || generateRandomString({ length: 5 });
-        const fileExtension = Files.getFileExtension(createFileDto.name);
-        const mimeType = Files.getMimeTypeFromFileExtension(createFileDto.name);
-        const filePath = `${createFileDto.scope}/${createFileDto.resource_id}/${fileId}.${fileExtension}`;
-        //
-        // C. Handle database transaction
-        const session = this.getMongoConnector().client.startSession();
-        let result;
-        try {
-            session.startTransaction();
-            //
-            // C.1. Handle file override if specified
-            if (options?.override) {
-                const existingFile = await this.findOne({ _id: fileId });
-                if (existingFile) {
-                    const existingFileExtension = Files.getFileExtension(existingFile.name);
-                    const existingFilePath = `${existingFile.scope}/${existingFile.resource_id}/${existingFile._id}.${existingFileExtension}`;
-                    if (existingFilePath !== filePath) {
-                        throw new HttpException(HTTP_STATUS.INTERNAL_SERVER_ERROR, 'File ID is provided, but the file path is different from the existing file', { cause: { existingFilePath, filePath } });
-                    }
-                    await super.deleteById(fileId);
-                }
-            }
-            //
-            // C.2. Upload file to storage
-            await this.storageService.uploadFile(filePath, file, mimeType);
-            //
-            // C.3. Insert file record
-            result = await this.insertOne({ ...createFileDto, _id: fileId, type: mimeType }, { options });
-            await session.commitTransaction();
-        }
-        catch (error) {
-            await session.abortTransaction();
-            throw error;
-        }
-        finally {
-            await session.endSession();
-        }
-        return result;
-    }
-    getCollectionIndexes() {
-        return [
-            { background: true, key: { created_by: 1 } },
-            { background: true, key: { updated_by: 1 } },
-            { background: true, key: { name: 1 } },
-            { background: true, key: { type: 1 } },
-            { background: true, key: { created_at: -1 } },
-            { background: true, key: { updated_at: -1 } },
-        ];
-    }
-    getCollectionName() {
-        return 'files';
-    }
-    getEnvName() {
-        return 'DATABASE_URI';
-    }
-}
-/* * */
-export const files = asyncSingletonProxy(FilesClass);

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

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

package/dist/interfaces/files/index.js

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

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

@@ -1,71 +0,0 @@
-import { MongoCollectionClass } from '../../common/mongo-collection.js';
-import { type CreateGtfsValidationDto, type GtfsValidation, type UpdateGtfsValidationDto } from '@tmlmobilidade/types';
-import { type IndexDescription } from 'mongodb';
-import { z } from 'zod';
-declare class GtfValidationsClass extends MongoCollectionClass<GtfsValidation, CreateGtfsValidationDto, UpdateGtfsValidationDto> {
-    private static _instance;
-    protected createSchema: z.ZodSchema;
-    protected updateSchema: z.ZodSchema;
-    private constructor();
-    static getInstance(): Promise<GtfValidationsClass>;
-    /**
-     * Finds GTFS Validation documents by agency ID.
-     * @param agencyId The agency ID to search for.
-     * @returns A promise that resolves to an array of matching documents
-     */
-    findByAgencyId(agencyId: string): Promise<import("mongodb").WithId<{
-        _id: string;
-        created_at: number & {
-            __brand: "UnixTimestamp";
-        };
-        created_by: string | null;
-        is_locked: boolean;
-        updated_at: number & {
-            __brand: "UnixTimestamp";
-        };
-        file_id: string;
-        processing_status: "error" | "waiting" | "processing" | "complete" | "skipped";
-        gtfs_agency: {
-            agency_id: string;
-            agency_name: string;
-            agency_timezone: string;
-            agency_email?: string | null | undefined;
-            agency_fare_url?: string | null | undefined;
-            agency_lang?: string | null | undefined;
-            agency_phone?: string | null | undefined;
-            agency_url?: string | null | undefined;
-        };
-        gtfs_feed_info: {
-            feed_lang: string;
-            feed_end_date?: import("@tmlmobilidade/types").OperationalDate | null | undefined;
-            feed_start_date?: import("@tmlmobilidade/types").OperationalDate | null | undefined;
-            default_lang?: string | null | undefined;
-            feed_contact_email?: string | null | undefined;
-            feed_contact_url?: string | null | undefined;
-            feed_publisher_name?: string | null | undefined;
-            feed_publisher_url?: string | null | undefined;
-            feed_version?: string | null | undefined;
-        };
-        notification_sent: boolean;
-        validation_attempts: number;
-        validity_status: "valid" | "unknown" | "invalid";
-        updated_by?: string | undefined;
-        summary?: {
-            messages: {
-                message: string;
-                file_name: string;
-                field: string;
-                rows: number[];
-                rule_id: string;
-                severity: "error" | "warning" | "ignore" | "forbidden";
-            }[];
-            total_errors: number;
-            total_warnings: number;
-        } | null | undefined;
-    }>[]>;
-    protected getCollectionIndexes(): IndexDescription[];
-    protected getCollectionName(): string;
-    protected getEnvName(): string;
-}
-export declare const gtfsValidations: GtfValidationsClass;
-export {};

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

@@ -1,40 +0,0 @@
-/* * */
-import { MongoCollectionClass } from '../../common/mongo-collection.js';
-import { CreateGtfsValidationSchema, UpdateGtfsValidationSchema } from '@tmlmobilidade/types';
-import { asyncSingletonProxy } from '@tmlmobilidade/utils';
-/* * */
-class GtfValidationsClass extends MongoCollectionClass {
-    static _instance;
-    createSchema = CreateGtfsValidationSchema;
-    updateSchema = UpdateGtfsValidationSchema;
-    constructor() {
-        super();
-    }
-    static async getInstance() {
-        if (!GtfValidationsClass._instance) {
-            const instance = new GtfValidationsClass();
-            await instance.connect();
-            GtfValidationsClass._instance = instance;
-        }
-        return GtfValidationsClass._instance;
-    }
-    /**
-     * Finds GTFS Validation documents by agency ID.
-     * @param agencyId The agency ID to search for.
-     * @returns A promise that resolves to an array of matching documents
-     */
-    async findByAgencyId(agencyId) {
-        return this.mongoCollection.find({ agency_id: agencyId }).toArray();
-    }
-    getCollectionIndexes() {
-        return [];
-    }
-    getCollectionName() {
-        return 'gtfs_validations';
-    }
-    getEnvName() {
-        return 'DATABASE_URI';
-    }
-}
-/* * */
-export const gtfsValidations = asyncSingletonProxy(GtfValidationsClass);

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

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

package/dist/interfaces/gtfs-validations/index.js

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

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

@@ -1,3 +0,0 @@
-export * from './pcgidb-legacy.js';
-export * from './pcgidb-ticketing.js';
-export * from './pcgidb-validations.js';

package/dist/interfaces/pcgidb/index.js

@@ -1,3 +0,0 @@
-export * from './pcgidb-legacy.js';
-export * from './pcgidb-ticketing.js';
-export * from './pcgidb-validations.js';

package/dist/interfaces/pcgidb/pcgidb-legacy.d.ts

@@ -1,21 +0,0 @@
-import { type Collection } from 'mongodb';
-declare class PCGIDBLegacyClass {
-    VehicleEventsCore: Collection;
-    VehicleEventsLog: Collection;
-    /**
-     * Establishes a connection to the Mongo database and initializes the collection.
-     * @throws If connection fails.
-     */
-    connect(): Promise<void>;
-    /**
-     * Sets up an SSH Tunnel, if required, and returns the appropriate database URL.
-     * @throws If required environment variables are missing or if the tunnel setup fails.
-     */
-    getPcgidbLegacyConnectionString(): Promise<string>;
-}
-/**
- * @deprecated This should not be used anymore. Only inside the `apex` module
- * and then you should use the services provided by the local package.
- */
-export declare const pcgidbLegacy: PCGIDBLegacyClass;
-export {};

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

@@ -1,82 +0,0 @@
-/* * */
-import { Logger } from '@tmlmobilidade/logger';
-import { MongoConnector } from '@tmlmobilidade/mongo';
-import { pcgiSshTunnel } from '@tmlmobilidade/ssh';
-/* * */
-let GLOBAL_PCGIDB_TUNNEL_INSTANCE;
-/* * */
-class PCGIDBLegacyClass {
-    //
-    VehicleEventsCore;
-    VehicleEventsLog;
-    /**
-     * Establishes a connection to the Mongo database and initializes the collection.
-     * @throws If connection fails.
-     */
-    async connect() {
-        //
-        //
-        // Setup SSH Tunnel, if required
-        const pcgidbLegacyConnectionString = await this.getPcgidbLegacyConnectionString();
-        //
-        // Get the database URI from environment variables
-        const mongoClientOptions = {
-            connectTimeoutMS: 10_000,
-            maxPoolSize: 20,
-            minPoolSize: 2,
-            readPreference: 'secondaryPreferred',
-            serverSelectionTimeoutMS: 10_000,
-        };
-        Logger.info({ message: 'Connecting to PCGIDB Legacy...' });
-        try {
-            // Connect to the MongoDB database
-            const mongoConnector = new MongoConnector(pcgidbLegacyConnectionString, mongoClientOptions);
-            await mongoConnector.connect();
-            // Setup collections
-            this.VehicleEventsCore = mongoConnector.client.db('CoreManagement').collection('VehicleEvents');
-            this.VehicleEventsLog = mongoConnector.client.db('OfferApiLog').collection('VehicleEvents');
-            // Log success message
-            Logger.success('Connected to PCGIDB Legacy successfully.');
-        }
-        catch (error) {
-            throw new Error('Error connecting to PCGIDB Legacy:', { cause: error });
-        }
-    }
-    /**
-     * Sets up an SSH Tunnel, if required, and returns the appropriate database URL.
-     * @throws If required environment variables are missing or if the tunnel setup fails.
-     */
-    async getPcgidbLegacyConnectionString() {
-        //
-        //
-        // Check if the required PCGIDB environment variables are set.
-        if (!process.env.PCGIDB_LEGACY_USER || !process.env.PCGIDB_LEGACY_PASSWORD) {
-            throw new Error('Missing PCGIDB_LEGACY_USER or PCGIDB_LEGACY_PASSWORD environment variable.');
-        }
-        if (!process.env.PCGIDB_LEGACY_ADDRESS_1 || !process.env.PCGIDB_LEGACY_ADDRESS_2 || !process.env.PCGIDB_LEGACY_ADDRESS_3 || !process.env.PCGIDB_LEGACY_PORT) {
-            throw new Error('Missing PCGIDB_LEGACY_ADDRESS_1, PCGIDB_LEGACY_ADDRESS_2, PCGIDB_LEGACY_ADDRESS_3 or PCGIDB_LEGACY_PORT environment variable.');
-        }
-        //
-        // Setup the SSH Tunnel connection configuration
-        GLOBAL_PCGIDB_TUNNEL_INSTANCE = pcgiSshTunnel({ dstAddr: process.env.PCGIDB_LEGACY_ADDRESS_1, dstPort: Number(process.env.PCGIDB_LEGACY_PORT) });
-        if (!GLOBAL_PCGIDB_TUNNEL_INSTANCE) {
-            return `mongodb://${process.env.PCGIDB_LEGACY_USER}:${process.env.PCGIDB_LEGACY_PASSWORD}@${process.env.PCGIDB_LEGACY_ADDRESS_1}:${process.env.PCGIDB_LEGACY_PORT},${process.env.PCGIDB_LEGACY_ADDRESS_2}:${process.env.PCGIDB_LEGACY_PORT},${process.env.PCGIDB_LEGACY_ADDRESS_3}:${process.env.PCGIDB_LEGACY_PORT}/`;
-        }
-        Logger.info({ message: 'Setting up SSH Tunnel for PCGIDB Legacy...' });
-        const sshTunnelConnection = await GLOBAL_PCGIDB_TUNNEL_INSTANCE.connect();
-        //
-        // Construct the PCGIDB connection string using the SSH Tunnel local address
-        const localAddress = sshTunnelConnection.address();
-        if (!localAddress || typeof localAddress !== 'object') {
-            throw new Error('Failed to retrieve the SSH tunnel address for PCGIDB Legacy.');
-        }
-        return `mongodb://${process.env.PCGIDB_LEGACY_USER}:${process.env.PCGIDB_LEGACY_PASSWORD}@localhost:${localAddress.port}/?directConnection=true`;
-        //
-    }
-}
-/* * */
-/**
- * @deprecated This should not be used anymore. Only inside the `apex` module
- * and then you should use the services provided by the local package.
- */
-export const pcgidbLegacy = new PCGIDBLegacyClass();

package/dist/interfaces/pcgidb/pcgidb-ticketing.d.ts

@@ -1,20 +0,0 @@
-import { type Collection } from 'mongodb';
-declare class PCGIDBTicketingClass {
-    SalesEntity: Collection;
-    /**
-     * Establishes a connection to the Mongo database and initializes the collection.
-     * @throws If connection fails.
-     */
-    connect(): Promise<void>;
-    /**
-     * Sets up an SSH Tunnel, if required, and returns the appropriate database URL.
-     * @throws If required environment variables are missing or if the tunnel setup fails.
-     */
-    getPcgidbTicketingConnectionString(): Promise<string>;
-}
-/**
- * @deprecated This should not be used anymore. Only inside the `apex` module
- * and then you should use the services provided by the local package.
- */
-export declare const pcgidbTicketing: PCGIDBTicketingClass;
-export {};

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

@@ -1,81 +0,0 @@
-/* * */
-import { Logger } from '@tmlmobilidade/logger';
-import { MongoConnector } from '@tmlmobilidade/mongo';
-import { pcgiSshTunnel } from '@tmlmobilidade/ssh';
-/* * */
-let GLOBAL_PCGIDB_TUNNEL_INSTANCE;
-/* * */
-class PCGIDBTicketingClass {
-    //
-    SalesEntity;
-    /**
-     * Establishes a connection to the Mongo database and initializes the collection.
-     * @throws If connection fails.
-     */
-    async connect() {
-        //
-        //
-        // Setup SSH Tunnel, if required
-        const pcgidbTicketingConnectionString = await this.getPcgidbTicketingConnectionString();
-        //
-        // Get the database URI from environment variables
-        const mongoClientOptions = {
-            connectTimeoutMS: 10_000,
-            directConnection: process.env.ENVIRONMENT === 'production' || process.env.ENVIRONMENT === 'staging' ? false : true,
-            maxPoolSize: 20,
-            minPoolSize: 2,
-            readPreference: 'secondaryPreferred',
-            serverSelectionTimeoutMS: 10_000,
-        };
-        Logger.info({ message: 'Connecting to PCGIDB Ticketing...' });
-        try {
-            // Connect to the MongoDB database
-            const mongoConnector = new MongoConnector(pcgidbTicketingConnectionString, mongoClientOptions);
-            await mongoConnector.connect();
-            // Setup collections
-            this.SalesEntity = mongoConnector.client.db('SalesManagement').collection('salesEntity');
-            // Log success message
-            Logger.success('Connected to PCGIDB Ticketing successfully.');
-        }
-        catch (error) {
-            throw new Error('Error connecting to PCGIDB Ticketing:', { cause: error });
-        }
-    }
-    /**
-     * Sets up an SSH Tunnel, if required, and returns the appropriate database URL.
-     * @throws If required environment variables are missing or if the tunnel setup fails.
-     */
-    async getPcgidbTicketingConnectionString() {
-        //
-        //
-        // Check if the required PCGIDB environment variables are set.
-        if (!process.env.PCGIDB_TICKETING_USER || !process.env.PCGIDB_TICKETING_PASSWORD) {
-            throw new Error('Missing PCGIDB_TICKETING_USER or PCGIDB_TICKETING_PASSWORD environment variable.');
-        }
-        if (!process.env.PCGIDB_TICKETING_ADDRESS_1 || !process.env.PCGIDB_TICKETING_ADDRESS_2 || !process.env.PCGIDB_TICKETING_ADDRESS_3 || !process.env.PCGIDB_TICKETING_PORT) {
-            throw new Error('Missing PCGIDB_TICKETING_ADDRESS_1, PCGIDB_TICKETING_ADDRESS_2, PCGIDB_TICKETING_ADDRESS_3 or PCGIDB_TICKETING_PORT environment variable.');
-        }
-        //
-        // Setup the SSH Tunnel
-        GLOBAL_PCGIDB_TUNNEL_INSTANCE = pcgiSshTunnel({ dstAddr: process.env.PCGIDB_TICKETING_ADDRESS_1, dstPort: Number(process.env.PCGIDB_TICKETING_PORT) });
-        if (!GLOBAL_PCGIDB_TUNNEL_INSTANCE) {
-            return `mongodb://${process.env.PCGIDB_TICKETING_USER}:${process.env.PCGIDB_TICKETING_PASSWORD}@${process.env.PCGIDB_TICKETING_ADDRESS_1}:${process.env.PCGIDB_TICKETING_PORT},${process.env.PCGIDB_TICKETING_ADDRESS_2}:${process.env.PCGIDB_TICKETING_PORT},${process.env.PCGIDB_TICKETING_ADDRESS_3}:${process.env.PCGIDB_TICKETING_PORT}/`;
-        }
-        Logger.info({ message: 'Setting up SSH Tunnel for PCGIDB Ticketing...' });
-        const sshTunnelConnection = await GLOBAL_PCGIDB_TUNNEL_INSTANCE.connect();
-        //
-        // Construct the PCGIDB connection string using the SSH Tunnel local address
-        const localAddress = sshTunnelConnection.address();
-        if (!localAddress || typeof localAddress !== 'object') {
-            throw new Error('Failed to retrieve the SSH tunnel address for PCGIDB Ticketing.');
-        }
-        return `mongodb://${process.env.PCGIDB_TICKETING_USER}:${process.env.PCGIDB_TICKETING_PASSWORD}@localhost:${localAddress.port}/`;
-        //
-    }
-}
-/* * */
-/**
- * @deprecated This should not be used anymore. Only inside the `apex` module
- * and then you should use the services provided by the local package.
- */
-export const pcgidbTicketing = new PCGIDBTicketingClass();

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

@@ -1,21 +0,0 @@
-import { type Collection } from 'mongodb';
-declare class PCGIDBValidationsClass {
-    LocationEntity: Collection;
-    ValidationEntity: Collection;
-    /**
-     * Establishes a connection to the Mongo database and initializes the collection.
-     * @throws If connection fails.
-     */
-    connect(): Promise<void>;
-    /**
-     * Sets up an SSH Tunnel, if required, and returns the appropriate database URL.
-     * @throws If required environment variables are missing or if the tunnel setup fails.
-     */
-    getPcgidbValidationsConnectionString(): Promise<string>;
-}
-/**
- * @deprecated This should not be used anymore. Only inside the `apex` module
- * and then you should use the services provided by the local package.
- */
-export declare const pcgidbValidations: PCGIDBValidationsClass;
-export {};

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

@@ -1,84 +0,0 @@
-/* * */
-import { Logger } from '@tmlmobilidade/logger';
-import { MongoConnector } from '@tmlmobilidade/mongo';
-import { pcgiSshTunnel } from '@tmlmobilidade/ssh';
-/* * */
-let GLOBAL_PCGIDB_TUNNEL_INSTANCE;
-/* * */
-class PCGIDBValidationsClass {
-    //
-    LocationEntity;
-    ValidationEntity;
-    /**
-     * Establishes a connection to the Mongo database and initializes the collection.
-     * @throws If connection fails.
-     */
-    async connect() {
-        //
-        //
-        // Setup SSH Tunnel, if required
-        const pcgidbValidationsConnectionString = await this.getPcgidbValidationsConnectionString();
-        //
-        // Get the database URI from environment variables
-        const mongoClientOptions = {
-            connectTimeoutMS: 10_000,
-            directConnection: process.env.ENVIRONMENT === 'production' || process.env.ENVIRONMENT === 'staging' ? false : true,
-            maxPoolSize: 20,
-            minPoolSize: 2,
-            readPreference: 'secondaryPreferred',
-            serverSelectionTimeoutMS: 10_000,
-        };
-        Logger.info({ message: 'Connecting to PCGIDB Validations...' });
-        try {
-            // Connect to the MongoDB database
-            const mongoConnector = new MongoConnector(pcgidbValidationsConnectionString, mongoClientOptions);
-            await mongoConnector.connect();
-            // Setup collections
-            this.LocationEntity = mongoConnector.client.db('LocationManagement').collection('locationEntity');
-            this.ValidationEntity = mongoConnector.client.db('ValidationsManagement').collection('validationEntity');
-            // Log success message
-            Logger.success('Connected to PCGIDB Validations successfully.');
-        }
-        catch (error) {
-            throw new Error('Error connecting to PCGIDB Validations:', { cause: error });
-        }
-    }
-    /**
-     * Sets up an SSH Tunnel, if required, and returns the appropriate database URL.
-     * @throws If required environment variables are missing or if the tunnel setup fails.
-     */
-    async getPcgidbValidationsConnectionString() {
-        //
-        //
-        // Check if the required PCGIDB environment variables are set.
-        if (!process.env.PCGIDB_VALIDATIONS_USER || !process.env.PCGIDB_VALIDATIONS_PASSWORD) {
-            throw new Error('Missing PCGIDB_VALIDATIONS_USER or PCGIDB_VALIDATIONS_PASSWORD environment variable.');
-        }
-        if (!process.env.PCGIDB_VALIDATIONS_ADDRESS_1 || !process.env.PCGIDB_VALIDATIONS_ADDRESS_2 || !process.env.PCGIDB_VALIDATIONS_ADDRESS_3 || !process.env.PCGIDB_VALIDATIONS_PORT) {
-            throw new Error('Missing PCGIDB_VALIDATIONS_ADDRESS_1, PCGIDB_VALIDATIONS_ADDRESS_2, PCGIDB_VALIDATIONS_ADDRESS_3 or PCGIDB_VALIDATIONS_PORT environment variable.');
-        }
-        //
-        // Setup the SSH Tunnel
-        GLOBAL_PCGIDB_TUNNEL_INSTANCE = pcgiSshTunnel({ dstAddr: process.env.PCGIDB_VALIDATIONS_ADDRESS_1, dstPort: Number(process.env.PCGIDB_VALIDATIONS_PORT) });
-        if (!GLOBAL_PCGIDB_TUNNEL_INSTANCE) {
-            return `mongodb://${process.env.PCGIDB_VALIDATIONS_USER}:${process.env.PCGIDB_VALIDATIONS_PASSWORD}@${process.env.PCGIDB_VALIDATIONS_ADDRESS_1}:${process.env.PCGIDB_VALIDATIONS_PORT},${process.env.PCGIDB_VALIDATIONS_ADDRESS_2}:${process.env.PCGIDB_VALIDATIONS_PORT},${process.env.PCGIDB_VALIDATIONS_ADDRESS_3}:${process.env.PCGIDB_VALIDATIONS_PORT}/`;
-        }
-        //
-        Logger.info({ message: 'Setting up SSH Tunnel for PCGIDB Validations...' });
-        const sshTunnelConnection = await GLOBAL_PCGIDB_TUNNEL_INSTANCE.connect();
-        //
-        // Construct the PCGIDB connection string using the SSH Tunnel local address
-        const localAddress = sshTunnelConnection.address();
-        if (!localAddress || typeof localAddress !== 'object') {
-            throw new Error('Failed to retrieve the SSH tunnel address for PCGIDB Validations.');
-        }
-        return `mongodb://${process.env.PCGIDB_VALIDATIONS_USER}:${process.env.PCGIDB_VALIDATIONS_PASSWORD}@localhost:${localAddress.port}/`;
-        //
-    }
-}
-/* * */
-/**
- * @deprecated This should not be used anymore. Only inside the `apex` module
- * and then you should use the services provided by the local package.
- */
-export const pcgidbValidations = new PCGIDBValidationsClass();

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

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

package/dist/interfaces/plans/index.js

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