@tmlmobilidade/mongo 20251202.1817.5

package/dist/index.d.ts

@@ -0,0 +1,39 @@
+import { type Collection, type Db, type DbOptions, type Document, MongoClient, type MongoClientOptions } from 'mongodb';
+export declare class MongoConnector {
+    /**
+     * Get the MongoClient instance.
+     */
+    get client(): MongoClient;
+    private _client;
+    constructor(uri: string, options?: MongoClientOptions);
+    /**
+     * Aggregates data from a collection.
+     */
+    aggregate<T extends Document>(collection: Collection<T>, pipeline: Document[]): Promise<Document[]>;
+    /**
+     * Connect to MongoDB and return the database instance.
+     */
+    connect(): Promise<MongoClient>;
+    /**
+     * Create a new Db instance sharing the current socket connections.
+     *
+     * @param dbName - The name of the database we want to use. If not provided, use database name from connection string.
+     * @param options - Optional settings for Db construction
+     */
+    db(dbName?: string, options?: DbOptions): Db;
+    /**
+   * Close the MongoDB connection.
+   */
+    disconnect(): Promise<void>;
+    /**
+     * Get a specific collection by name.
+     * @param db - The database instance.
+     * @param collectionName - The name of the collection to retrieve.
+     * @returns The collection instance.
+     */
+    getCollection<T extends Document>(db: Db, collectionName: string): Promise<Collection<T>>;
+    /**
+     * Watches a collection for changes.
+     */
+    watch<T extends Document>(collection: Collection<T>): Promise<import("mongodb").ChangeStream<T, import("mongodb").ChangeStreamDocument<T>>>;
+}

package/dist/index.js

@@ -0,0 +1,75 @@
+/* * */
+import { MongoClient } from 'mongodb';
+/* * */
+export class MongoConnector {
+    /**
+     * Get the MongoClient instance.
+     */
+    get client() {
+        return this._client;
+    }
+    _client;
+    constructor(uri, options) {
+        this._client = new MongoClient(uri, options);
+        this._client.on('close', () => {
+            console.warn('MongoDB connection closed unexpectedly.');
+        });
+        this._client.on('reconnect', () => {
+            console.log('MongoDB reconnected.');
+        });
+    }
+    /**
+     * Aggregates data from a collection.
+     */
+    async aggregate(collection, pipeline) {
+        return collection.aggregate(pipeline).toArray();
+    }
+    /**
+     * Connect to MongoDB and return the database instance.
+     */
+    async connect() {
+        if (!this._client) {
+            throw new Error('MongoClient not initialized');
+        }
+        try {
+            await this._client.connect();
+            return this._client;
+        }
+        catch (error) {
+            throw new Error('Error connecting to MongoDB', { cause: error });
+        }
+    }
+    /**
+     * Create a new Db instance sharing the current socket connections.
+     *
+     * @param dbName - The name of the database we want to use. If not provided, use database name from connection string.
+     * @param options - Optional settings for Db construction
+     */
+    db(dbName, options) {
+        return this._client.db(dbName, options);
+    }
+    /**
+   * Close the MongoDB connection.
+   */
+    async disconnect() {
+        if (this._client) {
+            await this._client.close();
+            console.log('⤷ Disconnected from MongoDB.');
+        }
+    }
+    /**
+     * Get a specific collection by name.
+     * @param db - The database instance.
+     * @param collectionName - The name of the collection to retrieve.
+     * @returns The collection instance.
+     */
+    async getCollection(db, collectionName) {
+        return db.collection(collectionName);
+    }
+    /**
+     * Watches a collection for changes.
+     */
+    async watch(collection) {
+        return collection.watch();
+    }
+}

package/package.json

@@ -0,0 +1,48 @@
+{
+	"name": "@tmlmobilidade/mongo",
+	"version": "20251202.1817.5",
+	"author": {
+		"email": "iso@tmlmobilidade.pt",
+		"name": "TML-ISO"
+	},
+	"license": "AGPL-3.0-or-later",
+	"homepage": "https://github.com/tmlmobilidade/go#readme",
+	"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": {
+		"mongodb": "7.0.0"
+	},
+	"devDependencies": {
+		"@tmlmobilidade/tsconfig": "*",
+		"@types/node": "24.10.1",
+		"resolve-tspaths": "0.8.23",
+		"tsc-watch": "7.2.0",
+		"typescript": "5.9.3"
+	}
+}