@ebarahona/loopback-connector-mongodb 1.0.0

package/dist/mongo.component.d.ts

@@ -0,0 +1,59 @@
+import { Binding, Component, Constructor, LifeCycleObserver } from '@loopback/core';
+import { MongoConnectionManager } from './helpers/connection-manager';
+import type { MongoService } from './services/mongo.service';
+/**
+ * Lifecycle observer that connects and disconnects the shared
+ * MongoConnectionManager.
+ *
+ * On stop, also closes any change streams opened through the
+ * `MongoService` (if bound) before disconnecting the client, to
+ * prevent server-side cursor leaks on app shutdown.
+ *
+ * Idempotent: repeated start/stop cycles are safe.
+ *
+ * @public
+ */
+export declare class MongoLifecycleObserver implements LifeCycleObserver {
+    private manager;
+    private service?;
+    constructor(manager: MongoConnectionManager, service?: MongoService | undefined);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}
+/**
+ * LoopBack 4 component that provides MongoDB connectivity.
+ *
+ * Registers:
+ * - MongoBindings.CONNECTION_MANAGER -- shared MongoConnectionManager
+ *   singleton; owns the MongoClient and its lifecycle.
+ * - MongoBindings.SERVICE -- MongoService singleton for advanced
+ *   native operations (aggregation, Change Streams, GridFS, ...).
+ * - MongoBindings.DATASOURCE -- juggler DataSource singleton wired
+ *   to the shared manager, for repository-based code paths.
+ * - MongoBindings.DATASOURCE_FACTORY -- factory for per-tenant
+ *   or per-database DataSource instances on the shared pool.
+ * - MongoLifecycleObserver -- connects on start, disconnects on stop.
+ *
+ * The juggler DataSource, the repositories built on it, and the
+ * MongoService all share one MongoConnectionManager, guaranteeing
+ * one connection pool, one lifecycle, and one topology state.
+ *
+ * Usage:
+ * ```typescript
+ * const app = new Application();
+ * app.bind(MongoBindings.CONFIG).to({
+ *   url: 'mongodb://localhost:27017',
+ *   database: 'mydb',
+ * });
+ * app.component(MongoComponent);
+ *
+ * const ds = await app.get(MongoBindings.DATASOURCE);
+ * const service = await app.get(MongoBindings.SERVICE);
+ * ```
+ *
+ * @public
+ */
+export declare class MongoComponent implements Component {
+    readonly bindings: Binding<unknown>[];
+    readonly lifeCycleObservers: Constructor<LifeCycleObserver>[];
+}

package/dist/mongo.component.js

@@ -0,0 +1,138 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MongoComponent = exports.MongoLifecycleObserver = void 0;
+const core_1 = require("@loopback/core");
+const debug_1 = __importDefault(require("debug"));
+const keys_1 = require("./keys");
+const connection_manager_1 = require("./helpers/connection-manager");
+const mongo_datasource_provider_1 = require("./datasource/mongo.datasource.provider");
+const mongo_datasource_factory_1 = require("./datasource/mongo.datasource.factory");
+const mongo_service_impl_1 = require("./services/mongo.service.impl");
+const debug = (0, debug_1.default)('loopback:connector:mongodb:lifecycle');
+/**
+ * Provider that creates a singleton MongoConnectionManager.
+ */
+let ConnectionManagerProvider = class ConnectionManagerProvider {
+    constructor(config) {
+        this.config = config;
+    }
+    value() {
+        return new connection_manager_1.MongoConnectionManager(this.config ?? {});
+    }
+};
+ConnectionManagerProvider = __decorate([
+    __param(0, (0, core_1.inject)(keys_1.MongoBindings.CONFIG, { optional: true })),
+    __metadata("design:paramtypes", [Object])
+], ConnectionManagerProvider);
+/**
+ * Lifecycle observer that connects and disconnects the shared
+ * MongoConnectionManager.
+ *
+ * On stop, also closes any change streams opened through the
+ * `MongoService` (if bound) before disconnecting the client, to
+ * prevent server-side cursor leaks on app shutdown.
+ *
+ * Idempotent: repeated start/stop cycles are safe.
+ *
+ * @public
+ */
+let MongoLifecycleObserver = class MongoLifecycleObserver {
+    constructor(manager, service) {
+        this.manager = manager;
+        this.service = service;
+    }
+    async start() {
+        await this.manager.connect();
+        debug('MongoClient connected');
+    }
+    async stop() {
+        if (this.service) {
+            try {
+                await this.service.closeAll();
+            }
+            catch (err) {
+                debug('closeAll failed during shutdown: %O', err);
+            }
+        }
+        await this.manager.disconnect();
+        debug('MongoClient disconnected');
+    }
+};
+exports.MongoLifecycleObserver = MongoLifecycleObserver;
+exports.MongoLifecycleObserver = MongoLifecycleObserver = __decorate([
+    (0, core_1.lifeCycleObserver)('mongodb'),
+    __param(0, (0, core_1.inject)(keys_1.MongoBindings.CONNECTION_MANAGER)),
+    __param(1, (0, core_1.inject)(keys_1.MongoBindings.SERVICE, { optional: true })),
+    __metadata("design:paramtypes", [connection_manager_1.MongoConnectionManager, Object])
+], MongoLifecycleObserver);
+/**
+ * LoopBack 4 component that provides MongoDB connectivity.
+ *
+ * Registers:
+ * - MongoBindings.CONNECTION_MANAGER -- shared MongoConnectionManager
+ *   singleton; owns the MongoClient and its lifecycle.
+ * - MongoBindings.SERVICE -- MongoService singleton for advanced
+ *   native operations (aggregation, Change Streams, GridFS, ...).
+ * - MongoBindings.DATASOURCE -- juggler DataSource singleton wired
+ *   to the shared manager, for repository-based code paths.
+ * - MongoBindings.DATASOURCE_FACTORY -- factory for per-tenant
+ *   or per-database DataSource instances on the shared pool.
+ * - MongoLifecycleObserver -- connects on start, disconnects on stop.
+ *
+ * The juggler DataSource, the repositories built on it, and the
+ * MongoService all share one MongoConnectionManager, guaranteeing
+ * one connection pool, one lifecycle, and one topology state.
+ *
+ * Usage:
+ * ```typescript
+ * const app = new Application();
+ * app.bind(MongoBindings.CONFIG).to({
+ *   url: 'mongodb://localhost:27017',
+ *   database: 'mydb',
+ * });
+ * app.component(MongoComponent);
+ *
+ * const ds = await app.get(MongoBindings.DATASOURCE);
+ * const service = await app.get(MongoBindings.SERVICE);
+ * ```
+ *
+ * @public
+ */
+class MongoComponent {
+    constructor() {
+        this.bindings = [
+            core_1.Binding.bind(keys_1.MongoBindings.CONNECTION_MANAGER)
+                .toProvider(ConnectionManagerProvider)
+                .inScope(core_1.BindingScope.SINGLETON),
+            core_1.Binding.bind(keys_1.MongoBindings.SERVICE)
+                .toClass(mongo_service_impl_1.MongoServiceImpl)
+                .inScope(core_1.BindingScope.SINGLETON),
+            core_1.Binding.bind(keys_1.MongoBindings.DATASOURCE)
+                .toProvider(mongo_datasource_provider_1.MongoDataSourceProvider)
+                .inScope(core_1.BindingScope.SINGLETON),
+            core_1.Binding.bind(keys_1.MongoBindings.DATASOURCE_FACTORY)
+                .toProvider(mongo_datasource_factory_1.MongoDataSourceFactoryProvider)
+                .inScope(core_1.BindingScope.SINGLETON),
+        ];
+        this.lifeCycleObservers = [
+            MongoLifecycleObserver,
+        ];
+    }
+}
+exports.MongoComponent = MongoComponent;
+//# sourceMappingURL=mongo.component.js.map

package/dist/mongo.component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongo.component.js","sourceRoot":"","sources":["../src/mongo.component.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;AAAA,yCAQwB;AACxB,kDAAiC;AACjC,iCAAqC;AACrC,qEAAoE;AACpE,sFAA+E;AAC/E,oFAAqF;AACrF,sEAA+D;AAI/D,MAAM,KAAK,GAAG,IAAA,eAAY,EAAC,sCAAsC,CAAC,CAAC;AAEnE;;GAEG;AACH,IAAM,yBAAyB,GAA/B,MAAM,yBAAyB;IAC7B,YAEU,MAA6B;QAA7B,WAAM,GAAN,MAAM,CAAuB;IACpC,CAAC;IAEJ,KAAK;QACH,OAAO,IAAI,2CAAsB,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC;CACF,CAAA;AATK,yBAAyB;IAE1B,WAAA,IAAA,aAAM,EAAC,oBAAa,CAAC,MAAM,EAAE,EAAC,QAAQ,EAAE,IAAI,EAAC,CAAC,CAAA;;GAF7C,yBAAyB,CAS9B;AAED;;;;;;;;;;;GAWG;AAEI,IAAM,sBAAsB,GAA5B,MAAM,sBAAsB;IACjC,YAEU,OAA+B,EAE/B,OAAsB;QAFtB,YAAO,GAAP,OAAO,CAAwB;QAE/B,YAAO,GAAP,OAAO,CAAe;IAC7B,CAAC;IAEJ,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QAC7B,KAAK,CAAC,uBAAuB,CAAC,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YAChC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,KAAK,CAAC,qCAAqC,EAAE,GAAG,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;QACD,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QAChC,KAAK,CAAC,0BAA0B,CAAC,CAAC;IACpC,CAAC;CACF,CAAA;AAxBY,wDAAsB;iCAAtB,sBAAsB;IADlC,IAAA,wBAAiB,EAAC,SAAS,CAAC;IAGxB,WAAA,IAAA,aAAM,EAAC,oBAAa,CAAC,kBAAkB,CAAC,CAAA;IAExC,WAAA,IAAA,aAAM,EAAC,oBAAa,CAAC,OAAO,EAAE,EAAC,QAAQ,EAAE,IAAI,EAAC,CAAC,CAAA;qCAD/B,2CAAsB;GAH9B,sBAAsB,CAwBlC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAa,cAAc;IAA3B;QACW,aAAQ,GAAuB;YACtC,cAAO,CAAC,IAAI,CAAC,oBAAa,CAAC,kBAAkB,CAAC;iBAC3C,UAAU,CAAC,yBAAyB,CAAC;iBACrC,OAAO,CAAC,mBAAY,CAAC,SAAS,CAAC;YAClC,cAAO,CAAC,IAAI,CAAC,oBAAa,CAAC,OAAO,CAAC;iBAChC,OAAO,CAAC,qCAAgB,CAAC;iBACzB,OAAO,CAAC,mBAAY,CAAC,SAAS,CAAC;YAClC,cAAO,CAAC,IAAI,CAAC,oBAAa,CAAC,UAAU,CAAC;iBACnC,UAAU,CAAC,mDAAuB,CAAC;iBACnC,OAAO,CAAC,mBAAY,CAAC,SAAS,CAAC;YAClC,cAAO,CAAC,IAAI,CAAC,oBAAa,CAAC,kBAAkB,CAAC;iBAC3C,UAAU,CAAC,yDAA8B,CAAC;iBAC1C,OAAO,CAAC,mBAAY,CAAC,SAAS,CAAC;SACnC,CAAC;QAEO,uBAAkB,GAAqC;YAC9D,sBAAsB;SACvB,CAAC;IACJ,CAAC;CAAA;AAnBD,wCAmBC"}

package/dist/providers/index.js

@@ -0,0 +1,4 @@
+"use strict";
+// Providers are internal to the component.
+// MongoConnectionManager is the public API for connection management.
+//# sourceMappingURL=index.js.map

package/dist/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":";AAAA,2CAA2C;AAC3C,sEAAsE"}

package/dist/services/index.d.ts

@@ -0,0 +1,2 @@
+export { MongoService } from './mongo.service';
+export { MongoServiceImpl, MongoTopologyError } from './mongo.service.impl';

package/dist/services/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MongoTopologyError = exports.MongoServiceImpl = void 0;
+var mongo_service_impl_1 = require("./mongo.service.impl");
+Object.defineProperty(exports, "MongoServiceImpl", { enumerable: true, get: function () { return mongo_service_impl_1.MongoServiceImpl; } });
+Object.defineProperty(exports, "MongoTopologyError", { enumerable: true, get: function () { return mongo_service_impl_1.MongoTopologyError; } });
+//# sourceMappingURL=index.js.map

package/dist/services/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":";;;AACA,2DAA0E;AAAlE,sHAAA,gBAAgB,OAAA;AAAE,wHAAA,kBAAkB,OAAA"}

package/dist/services/mongo.service.d.ts

@@ -0,0 +1,61 @@
+import type { MongoClient, Db, Collection, Document, AggregateOptions, AggregationCursor, ChangeStream, ChangeStreamOptions, ChangeStreamDocument, CreateCollectionOptions, TimeSeriesCollectionOptions, GridFSBucket, GridFSBucketOptions, ClientSession, TransactionOptions, AnyBulkWriteOperation, BulkWriteOptions, BulkWriteResult, IndexSpecification, CreateIndexesOptions, IndexDescription, ListDatabasesResult, FindOptions, Filter, FindCursor, Admin } from 'mongodb';
+/**
+ * Injectable service providing full native MongoDB driver access.
+ *
+ * Covers operations beyond CRUD that the connector/repository
+ * pattern does not support:
+ * - Aggregation pipelines
+ * - Change Streams (collection, database, client level)
+ * - Time Series collection creation with $jsonSchema
+ * - GridFS file storage
+ * - Transactions and sessions
+ * - Bulk operations
+ * - Tailable cursors
+ * - Index management
+ * - Admin commands
+ *
+ * Uses the same MongoClient singleton as the connector.
+ *
+ * @public
+ */
+export interface MongoService {
+    getClient(): MongoClient;
+    getDb(name?: string): Db;
+    getCollection<T extends Document>(name: string, db?: string): Collection<T>;
+    aggregate<T extends Document>(collection: string, pipeline: Document[], options?: AggregateOptions & {
+        db?: string;
+    }): Promise<T[]>;
+    aggregateCursor<T extends Document>(collection: string, pipeline: Document[], options?: AggregateOptions & {
+        db?: string;
+    }): AggregationCursor<T>;
+    watchCollection<T extends Document>(collection: string, pipeline?: Document[], options?: ChangeStreamOptions): ChangeStream<T, ChangeStreamDocument<T>>;
+    watchDatabase(pipeline?: Document[], options?: ChangeStreamOptions): ChangeStream;
+    watchClient(pipeline?: Document[], options?: ChangeStreamOptions): ChangeStream;
+    createTimeSeriesCollection(name: string, timeseriesOptions: TimeSeriesCollectionOptions, validatorSchema?: Document, options?: Omit<CreateCollectionOptions, 'timeseries' | 'validator'>): Promise<Collection>;
+    getGridFSBucket(bucketName?: string, options?: GridFSBucketOptions): GridFSBucket;
+    bulkWrite<T extends Document>(collection: string, operations: AnyBulkWriteOperation<T>[], options?: BulkWriteOptions & {
+        db?: string;
+    }): Promise<BulkWriteResult>;
+    withSession<T>(fn: (session: ClientSession) => Promise<T>): Promise<T>;
+    withTransaction<T>(fn: (session: ClientSession) => Promise<T>, options?: TransactionOptions): Promise<T>;
+    tailableCursor<T extends Document>(collection: string, filter?: Filter<T>, options?: FindOptions): FindCursor<T>;
+    createIndex(collection: string, indexSpec: IndexSpecification, options?: CreateIndexesOptions): Promise<string>;
+    createIndexes(collection: string, indexes: IndexDescription[], options?: CreateIndexesOptions): Promise<string[]>;
+    listIndexes(collection: string): Promise<Document[]>;
+    dropIndex(collection: string, indexName: string): Promise<void>;
+    admin(): Admin;
+    listDatabases(): Promise<ListDatabasesResult>;
+    listCollections(db?: string, filter?: Document): Promise<Document[]>;
+    dbStats(db?: string): Promise<Document>;
+    command(command: Document, db?: string): Promise<Document>;
+    isReplicaSet(): boolean;
+    getTopologyType(): string;
+    /**
+     * Close all change streams opened by this service. Idempotent.
+     * Called automatically by `MongoLifecycleObserver.stop()` to prevent
+     * server-side cursor leaks on app shutdown.
+     *
+     * @public
+     */
+    closeAll(): Promise<void>;
+}

package/dist/services/mongo.service.impl.d.ts

@@ -0,0 +1,58 @@
+import { MongoClient, Db, Collection, Document, AggregateOptions, AggregationCursor, ChangeStream, ChangeStreamOptions, ChangeStreamDocument, CreateCollectionOptions, TimeSeriesCollectionOptions, GridFSBucket, GridFSBucketOptions, ClientSession, TransactionOptions, AnyBulkWriteOperation, BulkWriteOptions, BulkWriteResult, IndexSpecification, CreateIndexesOptions, IndexDescription, ListDatabasesResult, FindOptions, Filter, FindCursor, Admin } from 'mongodb';
+import { MongoConnectionManager } from '../helpers/connection-manager';
+import type { MongoService } from './mongo.service';
+/**
+ * Thrown when an operation requires a replica set or sharded cluster
+ * but the connected server is a standalone instance.
+ *
+ * @public
+ */
+export declare class MongoTopologyError extends Error {
+    readonly name = "MongoTopologyError";
+    constructor(message: string);
+}
+/**
+ * Default implementation of {@link MongoService}, providing native MongoDB
+ * driver access on top of the shared {@link MongoConnectionManager}.
+ *
+ * @public
+ */
+export declare class MongoServiceImpl implements MongoService {
+    private manager;
+    private readonly openStreams;
+    constructor(manager: MongoConnectionManager);
+    getClient(): MongoClient;
+    getDb(name?: string): Db;
+    getCollection<T extends Document>(name: string, db?: string): Collection<T>;
+    aggregate<T extends Document>(collection: string, pipeline: Document[], options?: AggregateOptions & {
+        db?: string;
+    }): Promise<T[]>;
+    aggregateCursor<T extends Document>(collection: string, pipeline: Document[], options?: AggregateOptions & {
+        db?: string;
+    }): AggregationCursor<T>;
+    watchCollection<T extends Document>(collection: string, pipeline?: Document[], options?: ChangeStreamOptions): ChangeStream<T, ChangeStreamDocument<T>>;
+    watchDatabase(pipeline?: Document[], options?: ChangeStreamOptions): ChangeStream;
+    watchClient(pipeline?: Document[], options?: ChangeStreamOptions): ChangeStream;
+    private trackStream;
+    createTimeSeriesCollection(name: string, timeseriesOptions: TimeSeriesCollectionOptions, validatorSchema?: Document, options?: Omit<CreateCollectionOptions, 'timeseries' | 'validator'>): Promise<Collection>;
+    getGridFSBucket(bucketName?: string, options?: GridFSBucketOptions): GridFSBucket;
+    bulkWrite<T extends Document>(collection: string, operations: AnyBulkWriteOperation<T>[], options?: BulkWriteOptions & {
+        db?: string;
+    }): Promise<BulkWriteResult>;
+    withSession<T>(fn: (session: ClientSession) => Promise<T>): Promise<T>;
+    withTransaction<T>(fn: (session: ClientSession) => Promise<T>, options?: TransactionOptions): Promise<T>;
+    tailableCursor<T extends Document>(collection: string, filter?: Filter<T>, options?: FindOptions): FindCursor<T>;
+    createIndex(collection: string, indexSpec: IndexSpecification, options?: CreateIndexesOptions): Promise<string>;
+    createIndexes(collection: string, indexes: IndexDescription[], options?: CreateIndexesOptions): Promise<string[]>;
+    listIndexes(collection: string): Promise<Document[]>;
+    dropIndex(collection: string, indexName: string): Promise<void>;
+    admin(): Admin;
+    listDatabases(): Promise<ListDatabasesResult>;
+    listCollections(db?: string, filter?: Document): Promise<Document[]>;
+    dbStats(db?: string): Promise<Document>;
+    command(command: Document, db?: string): Promise<Document>;
+    isReplicaSet(): boolean;
+    getTopologyType(): string;
+    private assertReplicaSet;
+    closeAll(): Promise<void>;
+}

package/dist/services/mongo.service.impl.js

@@ -0,0 +1,211 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MongoServiceImpl = exports.MongoTopologyError = void 0;
+const core_1 = require("@loopback/core");
+const mongodb_1 = require("mongodb");
+const debug_1 = __importDefault(require("debug"));
+const keys_1 = require("../keys");
+const connection_manager_1 = require("../helpers/connection-manager");
+const debug = (0, debug_1.default)('loopback:connector:mongodb:service');
+/**
+ * Thrown when an operation requires a replica set or sharded cluster
+ * but the connected server is a standalone instance.
+ *
+ * @public
+ */
+class MongoTopologyError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'MongoTopologyError';
+    }
+}
+exports.MongoTopologyError = MongoTopologyError;
+/**
+ * Default implementation of {@link MongoService}, providing native MongoDB
+ * driver access on top of the shared {@link MongoConnectionManager}.
+ *
+ * @public
+ */
+let MongoServiceImpl = class MongoServiceImpl {
+    constructor(manager) {
+        this.openStreams = new Set();
+        this.manager = manager;
+    }
+    // ---- Core access ----
+    getClient() {
+        return this.manager.getClient();
+    }
+    getDb(name) {
+        return this.manager.getDb(name);
+    }
+    getCollection(name, db) {
+        return this.getDb(db).collection(name);
+    }
+    // ---- Aggregation ----
+    async aggregate(collection, pipeline, options) {
+        const { db, ...driverOptions } = options ?? {};
+        debug('aggregate [%s] stages=%d', collection, pipeline.length);
+        return this.getDb(db)
+            .collection(collection)
+            .aggregate(pipeline, driverOptions)
+            .toArray();
+    }
+    aggregateCursor(collection, pipeline, options) {
+        const { db, ...driverOptions } = options ?? {};
+        return this.getDb(db)
+            .collection(collection)
+            .aggregate(pipeline, driverOptions);
+    }
+    // ---- Change Streams ----
+    watchCollection(collection, pipeline, options) {
+        this.assertReplicaSet('watchCollection');
+        debug('watchCollection [%s]', collection);
+        const stream = this.getCollection(collection).watch(pipeline, options);
+        this.trackStream(stream);
+        return stream;
+    }
+    watchDatabase(pipeline, options) {
+        this.assertReplicaSet('watchDatabase');
+        debug('watchDatabase');
+        const stream = this.getDb().watch(pipeline, options);
+        this.trackStream(stream);
+        return stream;
+    }
+    watchClient(pipeline, options) {
+        this.assertReplicaSet('watchClient');
+        debug('watchClient');
+        const stream = this.manager.getClient().watch(pipeline, options);
+        this.trackStream(stream);
+        return stream;
+    }
+    trackStream(stream) {
+        this.openStreams.add(stream);
+        const cleanup = () => {
+            this.openStreams.delete(stream);
+        };
+        stream.once('close', cleanup);
+        stream.once('end', cleanup);
+    }
+    // ---- Time Series ----
+    async createTimeSeriesCollection(name, timeseriesOptions, validatorSchema, options) {
+        debug('createTimeSeriesCollection [%s] timeField=%s', name, timeseriesOptions.timeField);
+        const createOptions = {
+            ...options,
+            timeseries: timeseriesOptions,
+        };
+        if (validatorSchema) {
+            createOptions.validator = { $jsonSchema: validatorSchema };
+        }
+        return this.getDb().createCollection(name, createOptions);
+    }
+    // ---- GridFS ----
+    getGridFSBucket(bucketName, options) {
+        return new mongodb_1.GridFSBucket(this.getDb(), {
+            ...options,
+            ...(bucketName ? { bucketName } : {}),
+        });
+    }
+    // ---- Bulk operations ----
+    async bulkWrite(collection, operations, options) {
+        const { db, ...driverOptions } = options ?? {};
+        debug('bulkWrite [%s] ops=%d', collection, operations.length);
+        return this.getDb(db)
+            .collection(collection)
+            .bulkWrite(operations, driverOptions);
+    }
+    // ---- Transactions ----
+    async withSession(fn) {
+        return this.manager.getClient().withSession(fn);
+    }
+    async withTransaction(fn, options) {
+        let result;
+        await this.manager.getClient().withSession(async (session) => {
+            await session.withTransaction(async (s) => {
+                result = await fn(s);
+            }, options);
+        });
+        return result;
+    }
+    // ---- Tailable cursors ----
+    tailableCursor(collection, filter, options) {
+        debug('tailableCursor [%s]', collection);
+        const coll = this.getCollection(collection);
+        const emptyFilter = {};
+        return coll.find(filter ?? emptyFilter, {
+            ...options,
+            tailable: true,
+            awaitData: true,
+        });
+    }
+    // ---- Index management ----
+    async createIndex(collection, indexSpec, options) {
+        return this.getCollection(collection).createIndex(indexSpec, options);
+    }
+    async createIndexes(collection, indexes, options) {
+        return this.getCollection(collection).createIndexes(indexes, options);
+    }
+    async listIndexes(collection) {
+        return this.getCollection(collection).listIndexes().toArray();
+    }
+    async dropIndex(collection, indexName) {
+        await this.getCollection(collection).dropIndex(indexName);
+    }
+    // ---- Admin ----
+    admin() {
+        return this.getDb().admin();
+    }
+    async listDatabases() {
+        return this.admin().listDatabases();
+    }
+    async listCollections(db, filter) {
+        return this.getDb(db).listCollections(filter).toArray();
+    }
+    async dbStats(db) {
+        return this.getDb(db).stats();
+    }
+    async command(command, db) {
+        return this.getDb(db).command(command);
+    }
+    // ---- Topology ----
+    isReplicaSet() {
+        return this.manager.getTopology().isReplicaSet;
+    }
+    getTopologyType() {
+        return this.manager.getTopology().topologyType;
+    }
+    assertReplicaSet(operation) {
+        const topo = this.manager.getTopology();
+        if (!topo.isReplicaSet) {
+            throw new MongoTopologyError(`${operation} requires a replica set or sharded cluster. ` +
+                `Current topology: ${topo.topologyType}`);
+        }
+    }
+    // ---- Lifecycle ----
+    async closeAll() {
+        const streams = [...this.openStreams];
+        this.openStreams.clear();
+        await Promise.allSettled(streams.map(s => s.close()));
+    }
+};
+exports.MongoServiceImpl = MongoServiceImpl;
+exports.MongoServiceImpl = MongoServiceImpl = __decorate([
+    (0, core_1.injectable)({ scope: core_1.BindingScope.SINGLETON }),
+    __param(0, (0, core_1.inject)(keys_1.MongoBindings.CONNECTION_MANAGER)),
+    __metadata("design:paramtypes", [connection_manager_1.MongoConnectionManager])
+], MongoServiceImpl);
+//# sourceMappingURL=mongo.service.impl.js.map

package/dist/services/mongo.service.impl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongo.service.impl.js","sourceRoot":"","sources":["../../src/services/mongo.service.impl.ts"],"names":[],"mappings":"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"}

package/dist/services/mongo.service.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=mongo.service.js.map

package/dist/services/mongo.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongo.service.js","sourceRoot":"","sources":["../../src/services/mongo.service.ts"],"names":[],"mappings":""}