@tmlmobilidade/go-interfaces-pcgi-legacy 20260723.1350.16

package/dist/databases/core-management.d.ts

@@ -0,0 +1,8 @@
+import { MongoInterfaceTemplate } from '../interface.template.js';
+import { type MongoClient } from '@tmlmobilidade/go-clients-mongo';
+export declare class CoreManagementDatabase {
+    readonly vehicleEvents: MongoInterfaceTemplate<any>;
+    private readonly database;
+    private readonly databaseName;
+    constructor(instance: MongoClient);
+}

package/dist/databases/core-management.js

@@ -0,0 +1,15 @@
+/* * */
+import { MongoInterfaceTemplate } from '../interface.template.js';
+/* * */
+export class CoreManagementDatabase {
+    //
+    vehicleEvents;
+    database;
+    databaseName = 'CoreManagement';
+    constructor(instance) {
+        // Create the database instance
+        this.database = instance.db(this.databaseName);
+        // Create collection interfaces
+        this.vehicleEvents = new MongoInterfaceTemplate('VehicleEvents', this.database);
+    }
+}

package/dist/databases/offer-api-log.d.ts

@@ -0,0 +1,8 @@
+import { MongoInterfaceTemplate } from '../interface.template.js';
+import { type MongoClient } from '@tmlmobilidade/go-clients-mongo';
+export declare class OfferApiLogDatabase {
+    readonly vehicleEvents: MongoInterfaceTemplate<any>;
+    private readonly database;
+    private readonly databaseName;
+    constructor(instance: MongoClient);
+}

package/dist/databases/offer-api-log.js

@@ -0,0 +1,15 @@
+/* * */
+import { MongoInterfaceTemplate } from '../interface.template.js';
+/* * */
+export class OfferApiLogDatabase {
+    //
+    vehicleEvents;
+    database;
+    databaseName = 'OfferApiLog';
+    constructor(instance) {
+        // Create the database instance
+        this.database = instance.db(this.databaseName);
+        // Create collection interfaces
+        this.vehicleEvents = new MongoInterfaceTemplate('VehicleEvents', this.database);
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+import { CoreManagementDatabase } from './databases/core-management.js';
+import { OfferApiLogDatabase } from './databases/offer-api-log.js';
+declare class PCGILegacyClass {
+    private static _instance;
+    readonly coreManagement: CoreManagementDatabase;
+    readonly offerApiLog: OfferApiLogDatabase;
+    private constructor();
+    /**
+     * Establishes a connection to the Mongo database and initializes the collection.
+     * @param options Optional Mongo client connection options.
+     * @throws Error if the environment variable for the database URI is missing or if the connection fails.
+     */
+    static getInstance(): Promise<PCGILegacyClass>;
+}
+export declare const pcgiLegacy: PCGILegacyClass;
+export {};

package/dist/index.js

@@ -0,0 +1,30 @@
+/* * */
+import { MongoDatabaseClient } from '@tmlmobilidade/go-clients-mongo';
+import { asyncSingletonProxy } from '@tmlmobilidade/utils';
+import { CoreManagementDatabase } from './databases/core-management.js';
+import { OfferApiLogDatabase } from './databases/offer-api-log.js';
+/* * */
+class PCGILegacyClass {
+    //
+    static _instance;
+    coreManagement;
+    offerApiLog;
+    constructor(mongoClient) {
+        this.coreManagement = new CoreManagementDatabase(mongoClient);
+        this.offerApiLog = new OfferApiLogDatabase(mongoClient);
+    }
+    /**
+     * Establishes a connection to the Mongo database and initializes the collection.
+     * @param options Optional Mongo client connection options.
+     * @throws Error if the environment variable for the database URI is missing or if the connection fails.
+     */
+    static async getInstance() {
+        if (!PCGILegacyClass._instance) {
+            const mongoClient = await MongoDatabaseClient.getClient({ prefix: 'PCGI_LEGACY', tunnelType: 'PCGI' });
+            PCGILegacyClass._instance = new PCGILegacyClass(mongoClient);
+        }
+        return PCGILegacyClass._instance;
+    }
+}
+/* * */
+export const pcgiLegacy = asyncSingletonProxy(PCGILegacyClass);

package/dist/interface.template.d.ts

@@ -0,0 +1,44 @@
+import { type Collection, type Db, type Document, type Filter, type FindOptions, type WithId } from '@tmlmobilidade/go-clients-mongo';
+export declare class MongoInterfaceTemplate<T extends Document> {
+    private readonly collection;
+    /**
+     * @param collectionName The name of the collection to create the interface for.
+     * @param database The database to create the interface for.
+     */
+    constructor(collectionName: string, database: Db);
+    /**
+     * Counts documents matching the filter criteria.
+     * @param filter The filter criteria to match documents.
+     * @returns A promise that resolves to the count of matching documents.
+     */
+    count(filter?: Filter<T>): Promise<number>;
+    /**
+     * Finds all distinct values for a key in the collection.
+     * @param key The key to find distinct values for.
+     * @param filter Optional filter criteria to match documents before extracting distinct values.
+     * @returns A promise that resolves to an array of distinct values for the given key.
+     */
+    distinct<Key extends keyof WithId<T>>(key: Key, filter: Filter<T>): Promise<import("mongodb").Flatten<WithId<T>[Key]>[]>;
+    /**
+     * Finds multiple documents matching the filter criteria,
+     * with optional pagination and sorting.
+     * @param filter (Optional) filter criteria to match documents.
+     * @param options (Optional) find options.
+     * @returns A promise that resolves to an array of matching documents.
+     */
+    findMany(filter: Filter<T>, options?: FindOptions): Promise<WithId<T>[]>;
+    /**
+     * Finds a single document matching the filter criteria.
+     * @param filter The filter criteria to match the document.
+     * @param options Optional options.
+     * @returns A promise that resolves to the matching document or null if not found.
+     */
+    findOne(filter: Filter<T>, options?: FindOptions): Promise<T | null>;
+    /**
+     * Provides access to the MongoDB collection instance,
+     * initializing it if it has not already been created.
+     * @returns A promise that resolves to the MongoDB collection instance.
+     * @warning Use with caution: direct access to the collection allows for executing arbitrary queries.
+     */
+    getCollection(): Promise<Collection<T>>;
+}

package/dist/interface.template.js

@@ -0,0 +1,58 @@
+/* * */
+/* * */
+export class MongoInterfaceTemplate {
+    //
+    collection;
+    /**
+     * @param collectionName The name of the collection to create the interface for.
+     * @param database The database to create the interface for.
+     */
+    constructor(collectionName, database) {
+        this.collection = database.collection(collectionName);
+    }
+    /**
+     * Counts documents matching the filter criteria.
+     * @param filter The filter criteria to match documents.
+     * @returns A promise that resolves to the count of matching documents.
+     */
+    async count(filter) {
+        return await this.collection.countDocuments(filter);
+    }
+    /**
+     * Finds all distinct values for a key in the collection.
+     * @param key The key to find distinct values for.
+     * @param filter Optional filter criteria to match documents before extracting distinct values.
+     * @returns A promise that resolves to an array of distinct values for the given key.
+     */
+    async distinct(key, filter) {
+        return this.collection.distinct(key, filter);
+    }
+    /**
+     * Finds multiple documents matching the filter criteria,
+     * with optional pagination and sorting.
+     * @param filter (Optional) filter criteria to match documents.
+     * @param options (Optional) find options.
+     * @returns A promise that resolves to an array of matching documents.
+     */
+    async findMany(filter, options) {
+        return await this.collection.find(filter, options).toArray();
+    }
+    /**
+     * Finds a single document matching the filter criteria.
+     * @param filter The filter criteria to match the document.
+     * @param options Optional options.
+     * @returns A promise that resolves to the matching document or null if not found.
+     */
+    async findOne(filter, options) {
+        return await this.collection.findOne(filter, options);
+    }
+    /**
+     * Provides access to the MongoDB collection instance,
+     * initializing it if it has not already been created.
+     * @returns A promise that resolves to the MongoDB collection instance.
+     * @warning Use with caution: direct access to the collection allows for executing arbitrary queries.
+     */
+    async getCollection() {
+        return this.collection;
+    }
+}

package/package.json

@@ -0,0 +1,54 @@
+{
+	"name": "@tmlmobilidade/go-interfaces-pcgi-legacy",
+	"version": "20260723.1350.16",
+	"author": {
+		"email": "iso@tmlmobilidade.pt",
+		"name": "TML-ISO"
+	},
+	"license": "AGPL-3.0-or-later",
+	"homepage": "https://go.tmlmobilidade.pt",
+	"bugs": {
+		"url": "https://github.com/tmlmobilidade/go/issues"
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/tmlmobilidade/go.git"
+	},
+	"keywords": [
+		"public transit",
+		"tml",
+		"transportes metropolitanos de lisboa",
+		"go"
+	],
+	"publishConfig": {
+		"access": "public"
+	},
+	"type": "module",
+	"files": [
+		"dist"
+	],
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"scripts": {
+		"build": "tsc && resolve-tspaths",
+		"lint": "eslint ./src/ && tsc --noEmit",
+		"lint:fix": "eslint ./src/ --fix",
+		"watch": "tsc-watch --onSuccess 'resolve-tspaths'"
+	},
+	"dependencies": {
+		"@tmlmobilidade/go-clients-mongo": "*",
+		"@tmlmobilidade/go-types-vehicle-events": "*",
+		"@tmlmobilidade/logger": "*",
+		"@tmlmobilidade/utils": "*",
+		"luxon": "3.7.2",
+		"zod": "3.25.76"
+	},
+	"devDependencies": {
+		"@tmlmobilidade/tsconfig": "*",
+		"@types/luxon": "3.7.2",
+		"@types/node": "26.1.1",
+		"resolve-tspaths": "0.8.23",
+		"tsc-watch": "7.2.1",
+		"typescript": "6.0.3"
+	}
+}