@ebarahona/loopback-connector-mongodb 1.0.0

package/dist/helpers/config-validator.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MongoConfigError = void 0;
+exports.validateConfig = validateConfig;
+exports.redactUrl = redactUrl;
+/**
+ * Error thrown when the connector config fails framework-level
+ * validation before any MongoDB driver call is made.
+ *
+ * Messages never contain credentials -- the offending URL or
+ * config object is redacted before formatting.
+ *
+ * @public
+ */
+class MongoConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'MongoConfigError';
+    }
+}
+exports.MongoConfigError = MongoConfigError;
+const SUPPORTED_SCHEMES = new Set(['mongodb:', 'mongodb+srv:']);
+/**
+ * Validate connector config. Throws MongoConfigError for cases the
+ * driver would otherwise surface as opaque runtime errors:
+ * - neither `url` nor `host` set
+ * - `url` is not a parseable mongodb:// or mongodb+srv:// URL
+ *
+ * Everything else (auth shape, TLS, pool sizing) is passed through
+ * to the driver, which has good error messages for those.
+ *
+ * @public
+ */
+function validateConfig(config) {
+    if (!config) {
+        throw new MongoConfigError('MongoDB config is missing. Bind MongoBindings.CONFIG or ' +
+            'pass settings to the DataSource.');
+    }
+    if (!config.url && !config.host) {
+        throw new MongoConfigError('MongoDB config requires either `url` or `host`. Got neither.');
+    }
+    if (config.url) {
+        let parsed;
+        try {
+            parsed = new URL(config.url);
+        }
+        catch {
+            throw new MongoConfigError(`MongoDB url is not a valid URL: ${redactUrl(config.url)}`);
+        }
+        if (!SUPPORTED_SCHEMES.has(parsed.protocol)) {
+            throw new MongoConfigError(`MongoDB url scheme must be mongodb:// or mongodb+srv://, ` +
+                `got "${parsed.protocol}" in ${redactUrl(config.url)}`);
+        }
+    }
+}
+/**
+ * Replace `username:password@` with `<credentials>@` in a connection
+ * string. Safe to log. Handles credentials containing literal `@`
+ * characters by parsing the URL rather than relying on regex.
+ *
+ * @public
+ */
+function redactUrl(url) {
+    try {
+        const parsed = new URL(url);
+        if (parsed.username || parsed.password) {
+            parsed.username = '';
+            parsed.password = '';
+            return parsed.toString().replace('//', '//<credentials>@');
+        }
+        return url;
+    }
+    catch {
+        // Fall back to regex-based redaction if URL parsing fails (e.g.
+        // for non-URL inputs reused for logging).
+        return url.replace(/\/\/[^/]*@/, '//<credentials>@');
+    }
+}
+//# sourceMappingURL=config-validator.js.map

package/dist/helpers/config-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-validator.js","sourceRoot":"","sources":["../../src/helpers/config-validator.ts"],"names":[],"mappings":";;;AA+BA,wCA8BC;AASD,8BAcC;AAlFD;;;;;;;;GAQG;AACH,MAAa,gBAAiB,SAAQ,KAAK;IAEzC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,SAAI,GAAG,kBAAkB,CAAC;IAG5C,CAAC;CACF;AALD,4CAKC;AAED,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC,CAAC;AAEhE;;;;;;;;;;GAUG;AACH,SAAgB,cAAc,CAAC,MAAwC;IACrE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,gBAAgB,CACxB,0DAA0D;YACxD,kCAAkC,CACrC,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAChC,MAAM,IAAI,gBAAgB,CACxB,8DAA8D,CAC/D,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC;QACf,IAAI,MAAW,CAAC;QAChB,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,gBAAgB,CACxB,mCAAmC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAC3D,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5C,MAAM,IAAI,gBAAgB,CACxB,2DAA2D;gBACzD,QAAQ,MAAM,CAAC,QAAQ,QAAQ,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACzD,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,SAAS,CAAC,GAAW;IACnC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACvC,MAAM,CAAC,QAAQ,GAAG,EAAE,CAAC;YACrB,MAAM,CAAC,QAAQ,GAAG,EAAE,CAAC;YACrB,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;QAC7D,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAAC,MAAM,CAAC;QACP,gEAAgE;QAChE,0CAA0C;QAC1C,OAAO,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,kBAAkB,CAAC,CAAC;IACvD,CAAC;AACH,CAAC"}

package/dist/helpers/connection-manager.d.ts

@@ -0,0 +1,78 @@
+import type { Db } from 'mongodb';
+import { MongoClient } from 'mongodb';
+import type { MongoConnectorConfig } from '../types';
+import type { TopologyInfo } from './topology';
+/**
+ * Thrown when an operation against the connection manager is invalid
+ * for its current state (no client connected, manager disposed, etc.).
+ *
+ * @public
+ */
+export declare class MongoConnectionError extends Error {
+    readonly name = "MongoConnectionError";
+    constructor(message: string);
+}
+/**
+ * Centralized connection manager for the MongoDB client.
+ *
+ * Owns one MongoClient singleton. Both the juggler connector and
+ * MongoService use the same manager, guaranteeing one connection
+ * pool, one lifecycle, and one topology state.
+ *
+ * - `connect()` is idempotent and concurrency-safe.
+ * - `disconnect()` is idempotent and coordinates with in-flight connects.
+ * - Repeated start/stop cycles are safe (test restarts, hot reload).
+ * - A generation counter prevents stale connect from overriding disconnect.
+ *
+ * @public
+ */
+export declare class MongoConnectionManager {
+    private readonly config;
+    private client?;
+    private db?;
+    private state;
+    private connectPromise?;
+    private disconnectPromise?;
+    private topologyInfo?;
+    private generation;
+    constructor(config: MongoConnectorConfig);
+    /**
+     * Connect to MongoDB. Idempotent and concurrency-safe.
+     * Concurrent calls share the same connection promise.
+     * If disconnect is in progress, awaits the real disconnect
+     * promise (no spin wait, no timeout) before starting connect.
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from MongoDB. Idempotent and concurrency-safe.
+     * Concurrent calls share the same disconnect promise.
+     * Waits for any in-flight connect to settle before closing.
+     * Uses generation counter to prevent stale connect from
+     * overriding this disconnect.
+     */
+    disconnect(): Promise<void>;
+    private doDisconnect;
+    /**
+     * Get the connected MongoClient. Throws if not connected.
+     */
+    getClient(): MongoClient;
+    /**
+     * Get the default Db instance. Throws if not connected.
+     */
+    getDb(name?: string): Db;
+    /**
+     * Get topology info. Best-effort detection using driver internals.
+     * Returns unknown topology if not connected.
+     */
+    getTopology(): TopologyInfo;
+    /**
+     * Whether the client is connected.
+     */
+    isConnected(): boolean;
+    /**
+     * Ping the server. Throws if not connected or server unreachable.
+     */
+    ping(): Promise<void>;
+    private doConnect;
+    private extractDatabaseFromUrl;
+}

package/dist/helpers/connection-manager.js

@@ -0,0 +1,212 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MongoConnectionManager = exports.MongoConnectionError = void 0;
+const mongodb_1 = require("mongodb");
+const debug_1 = __importDefault(require("debug"));
+const url_builder_1 = require("./url-builder");
+const config_validator_1 = require("./config-validator");
+const topology_1 = require("./topology");
+const debug = (0, debug_1.default)('loopback:connector:mongodb:connection');
+/**
+ * Thrown when an operation against the connection manager is invalid
+ * for its current state (no client connected, manager disposed, etc.).
+ *
+ * @public
+ */
+class MongoConnectionError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'MongoConnectionError';
+    }
+}
+exports.MongoConnectionError = MongoConnectionError;
+/**
+ * Centralized connection manager for the MongoDB client.
+ *
+ * Owns one MongoClient singleton. Both the juggler connector and
+ * MongoService use the same manager, guaranteeing one connection
+ * pool, one lifecycle, and one topology state.
+ *
+ * - `connect()` is idempotent and concurrency-safe.
+ * - `disconnect()` is idempotent and coordinates with in-flight connects.
+ * - Repeated start/stop cycles are safe (test restarts, hot reload).
+ * - A generation counter prevents stale connect from overriding disconnect.
+ *
+ * @public
+ */
+class MongoConnectionManager {
+    constructor(config) {
+        this.config = config;
+        this.state = 'disconnected';
+        this.generation = 0;
+    }
+    /**
+     * Connect to MongoDB. Idempotent and concurrency-safe.
+     * Concurrent calls share the same connection promise.
+     * If disconnect is in progress, awaits the real disconnect
+     * promise (no spin wait, no timeout) before starting connect.
+     */
+    async connect() {
+        if (this.isConnected())
+            return;
+        if (this.disconnectPromise) {
+            try {
+                await this.disconnectPromise;
+            }
+            catch {
+                // disconnect failed; proceed with a fresh connect
+            }
+        }
+        if (this.isConnected())
+            return;
+        if (this.connectPromise) {
+            await this.connectPromise;
+            return;
+        }
+        const gen = this.generation;
+        this.state = 'connecting';
+        this.connectPromise = this.doConnect(gen).finally(() => {
+            this.connectPromise = undefined;
+        });
+        try {
+            await this.connectPromise;
+        }
+        catch (err) {
+            if (this.generation === gen) {
+                this.state = 'disconnected';
+            }
+            throw err;
+        }
+    }
+    /**
+     * Disconnect from MongoDB. Idempotent and concurrency-safe.
+     * Concurrent calls share the same disconnect promise.
+     * Waits for any in-flight connect to settle before closing.
+     * Uses generation counter to prevent stale connect from
+     * overriding this disconnect.
+     */
+    async disconnect() {
+        if (this.disconnectPromise) {
+            await this.disconnectPromise;
+            return;
+        }
+        if (this.state === 'disconnected' && !this.client && !this.connectPromise) {
+            return;
+        }
+        this.generation++;
+        this.state = 'disconnecting';
+        this.disconnectPromise = this.doDisconnect().finally(() => {
+            this.disconnectPromise = undefined;
+        });
+        await this.disconnectPromise;
+    }
+    async doDisconnect() {
+        if (this.connectPromise) {
+            try {
+                await this.connectPromise;
+            }
+            catch {
+                // connect failed; proceed with disconnect
+            }
+        }
+        if (this.client) {
+            try {
+                await this.client.close();
+            }
+            catch (err) {
+                debug('disconnect error: %O', err);
+            }
+        }
+        this.client = undefined;
+        this.db = undefined;
+        this.topologyInfo = undefined;
+        this.state = 'disconnected';
+        debug('disconnected');
+    }
+    /**
+     * Get the connected MongoClient. Throws if not connected.
+     */
+    getClient() {
+        if (!this.client || this.state !== 'connected') {
+            throw new MongoConnectionError('MongoClient is not connected');
+        }
+        return this.client;
+    }
+    /**
+     * Get the default Db instance. Throws if not connected.
+     */
+    getDb(name) {
+        if (!this.client || this.state !== 'connected') {
+            throw new MongoConnectionError('MongoClient is not connected');
+        }
+        if (name)
+            return this.client.db(name);
+        if (!this.db) {
+            throw new MongoConnectionError('MongoClient is not connected');
+        }
+        return this.db;
+    }
+    /**
+     * Get topology info. Best-effort detection using driver internals.
+     * Returns unknown topology if not connected.
+     */
+    getTopology() {
+        if (!this.client) {
+            return { isReplicaSet: false, topologyType: 'Unknown' };
+        }
+        return (0, topology_1.detectTopology)(this.client);
+    }
+    /**
+     * Whether the client is connected.
+     */
+    isConnected() {
+        return this.state === 'connected';
+    }
+    /**
+     * Ping the server. Throws if not connected or server unreachable.
+     */
+    async ping() {
+        const db = this.getDb();
+        await db.command({ ping: 1 });
+    }
+    async doConnect(gen) {
+        (0, config_validator_1.validateConfig)(this.config);
+        const url = (0, url_builder_1.buildConnectionUrl)(this.config);
+        debug('connecting to %s', (0, config_validator_1.redactUrl)(url));
+        const client = new mongodb_1.MongoClient(url, this.config.clientOptions);
+        try {
+            await client.connect();
+        }
+        catch (err) {
+            await client.close().catch(() => { });
+            throw err;
+        }
+        // Check generation: if disconnect happened during connect, don't
+        // set connected state -- close the client we just opened
+        if (this.generation !== gen) {
+            await client.close().catch(() => { });
+            throw new MongoConnectionError('Connection cancelled by disconnect');
+        }
+        this.client = client;
+        const dbName = this.config.database ?? this.extractDatabaseFromUrl(url);
+        this.db = client.db(dbName);
+        this.topologyInfo = (0, topology_1.detectTopology)(client);
+        this.state = 'connected';
+        debug('connected to database [%s] (topology: %s)', dbName, this.topologyInfo.topologyType);
+    }
+    extractDatabaseFromUrl(url) {
+        try {
+            const parsed = new URL(url);
+            const path = parsed.pathname;
+            return path.startsWith('/') ? path.slice(1) || 'test' : 'test';
+        }
+        catch {
+            return 'test';
+        }
+    }
+}
+exports.MongoConnectionManager = MongoConnectionManager;
+//# sourceMappingURL=connection-manager.js.map

package/dist/helpers/connection-manager.js.map

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

package/dist/helpers/index.d.ts

@@ -0,0 +1,5 @@
+export { detectTopology } from './topology';
+export type { TopologyInfo } from './topology';
+export { MongoConnectionManager, MongoConnectionError, } from './connection-manager';
+export { buildConnectionUrl } from './url-builder';
+export { MongoConfigError, validateConfig, redactUrl } from './config-validator';

package/dist/helpers/index.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.redactUrl = exports.validateConfig = exports.MongoConfigError = exports.buildConnectionUrl = exports.MongoConnectionError = exports.MongoConnectionManager = exports.detectTopology = void 0;
+var topology_1 = require("./topology");
+Object.defineProperty(exports, "detectTopology", { enumerable: true, get: function () { return topology_1.detectTopology; } });
+var connection_manager_1 = require("./connection-manager");
+Object.defineProperty(exports, "MongoConnectionManager", { enumerable: true, get: function () { return connection_manager_1.MongoConnectionManager; } });
+Object.defineProperty(exports, "MongoConnectionError", { enumerable: true, get: function () { return connection_manager_1.MongoConnectionError; } });
+var url_builder_1 = require("./url-builder");
+Object.defineProperty(exports, "buildConnectionUrl", { enumerable: true, get: function () { return url_builder_1.buildConnectionUrl; } });
+var config_validator_1 = require("./config-validator");
+Object.defineProperty(exports, "MongoConfigError", { enumerable: true, get: function () { return config_validator_1.MongoConfigError; } });
+Object.defineProperty(exports, "validateConfig", { enumerable: true, get: function () { return config_validator_1.validateConfig; } });
+Object.defineProperty(exports, "redactUrl", { enumerable: true, get: function () { return config_validator_1.redactUrl; } });
+//# sourceMappingURL=index.js.map

package/dist/helpers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":";;;AAAA,uCAA0C;AAAlC,0GAAA,cAAc,OAAA;AAEtB,2DAG8B;AAF5B,4HAAA,sBAAsB,OAAA;AACtB,0HAAA,oBAAoB,OAAA;AAEtB,6CAAiD;AAAzC,iHAAA,kBAAkB,OAAA;AAC1B,uDAA+E;AAAvE,oHAAA,gBAAgB,OAAA;AAAE,kHAAA,cAAc,OAAA;AAAE,6GAAA,SAAS,OAAA"}

package/dist/helpers/topology.d.ts

@@ -0,0 +1,23 @@
+import type { MongoClient } from 'mongodb';
+/**
+ * Describes the deployment topology shape of a connected MongoClient
+ * (standalone, replica set, sharded, or unknown).
+ *
+ * @public
+ */
+export interface TopologyInfo {
+    isReplicaSet: boolean;
+    topologyType: string;
+}
+/**
+ * Detect the topology type of a connected MongoClient.
+ * Call after client.connect() has resolved.
+ *
+ * @remarks
+ * Relies on driver internals (`client.topology.description.type`)
+ * which are not guaranteed stable across MongoDB driver majors and
+ * may need to be revisited on driver upgrades.
+ *
+ * @experimental
+ */
+export declare function detectTopology(client: MongoClient): TopologyInfo;

package/dist/helpers/topology.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectTopology = detectTopology;
+/**
+ * Detect the topology type of a connected MongoClient.
+ * Call after client.connect() has resolved.
+ *
+ * @remarks
+ * Relies on driver internals (`client.topology.description.type`)
+ * which are not guaranteed stable across MongoDB driver majors and
+ * may need to be revisited on driver upgrades.
+ *
+ * @experimental
+ */
+function detectTopology(client) {
+    // Access the internal topology description
+    // The topology property is available after connection
+    const description = client.topology?.description;
+    const type = description?.type ?? 'Unknown';
+    return {
+        isReplicaSet: type === 'ReplicaSetWithPrimary' ||
+            type === 'ReplicaSetNoPrimary' ||
+            type === 'Sharded',
+        topologyType: type,
+    };
+}
+//# sourceMappingURL=topology.js.map

package/dist/helpers/topology.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"topology.js","sourceRoot":"","sources":["../../src/helpers/topology.ts"],"names":[],"mappings":";;AAwBA,wCAkBC;AA7BD;;;;;;;;;;GAUG;AACH,SAAgB,cAAc,CAAC,MAAmB;IAChD,2CAA2C;IAC3C,sDAAsD;IACtD,MAAM,WAAW,GACf,MAGD,CAAC,QAAQ,EAAE,WAAW,CAAC;IAExB,MAAM,IAAI,GAAG,WAAW,EAAE,IAAI,IAAI,SAAS,CAAC;IAE5C,OAAO;QACL,YAAY,EACV,IAAI,KAAK,uBAAuB;YAChC,IAAI,KAAK,qBAAqB;YAC9B,IAAI,KAAK,SAAS;QACpB,YAAY,EAAE,IAAI;KACnB,CAAC;AACJ,CAAC"}

package/dist/helpers/url-builder.d.ts

@@ -0,0 +1,7 @@
+import type { MongoConnectorConfig } from '../types';
+/**
+ * Build a MongoDB connection URL from config.
+ * Single source of truth -- used by both the connection manager
+ * and the juggler initialize path.
+ */
+export declare function buildConnectionUrl(config: MongoConnectorConfig): string;

package/dist/helpers/url-builder.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildConnectionUrl = buildConnectionUrl;
+/**
+ * Build a MongoDB connection URL from config.
+ * Single source of truth -- used by both the connection manager
+ * and the juggler initialize path.
+ */
+function buildConnectionUrl(config) {
+    if (config.url)
+        return config.url;
+    const host = config.host ?? 'localhost';
+    const port = config.port ?? 27017;
+    const database = config.database ?? 'test';
+    let auth = '';
+    if (config.username && config.password) {
+        const user = encodeURIComponent(config.username);
+        const pass = encodeURIComponent(config.password);
+        auth = `${user}:${pass}@`;
+    }
+    const params = new URLSearchParams();
+    if (config.authSource)
+        params.set('authSource', config.authSource);
+    if (config.replicaSet)
+        params.set('replicaSet', config.replicaSet);
+    const queryString = params.toString();
+    const suffix = queryString ? `?${queryString}` : '';
+    return `mongodb://${auth}${host}:${port}/${database}${suffix}`;
+}
+//# sourceMappingURL=url-builder.js.map

package/dist/helpers/url-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-builder.js","sourceRoot":"","sources":["../../src/helpers/url-builder.ts"],"names":[],"mappings":";;AAOA,gDAsBC;AA3BD;;;;GAIG;AACH,SAAgB,kBAAkB,CAAC,MAA4B;IAC7D,IAAI,MAAM,CAAC,GAAG;QAAE,OAAO,MAAM,CAAC,GAAG,CAAC;IAElC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,WAAW,CAAC;IACxC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,KAAK,CAAC;IAClC,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC;IAE3C,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACvC,MAAM,IAAI,GAAG,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACjD,MAAM,IAAI,GAAG,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACjD,IAAI,GAAG,GAAG,IAAI,IAAI,IAAI,GAAG,CAAC;IAC5B,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;IACrC,IAAI,MAAM,CAAC,UAAU;QAAE,MAAM,CAAC,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;IACnE,IAAI,MAAM,CAAC,UAAU;QAAE,MAAM,CAAC,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;IAEnE,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IACtC,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAEpD,OAAO,aAAa,IAAI,GAAG,IAAI,IAAI,IAAI,IAAI,QAAQ,GAAG,MAAM,EAAE,CAAC;AACjE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+export { MongoComponent, MongoLifecycleObserver } from './mongo.component';
+export { MongoBindings } from './keys';
+export type { MongoConnectorConfig } from './types';
+export { MongoConnector, initialize } from './connector';
+export type { ModelDefinition, PropertyDefinition } from './connector';
+export { MongoDataSource, MongoDataSourceProvider, MongoDataSourceFactoryProvider, } from './datasource';
+export type { MongoDataSourceFactory } from './datasource';
+export { MongoConfigError, validateConfig, redactUrl } from './helpers';
+export { MongoService } from './services';
+export { MongoServiceImpl } from './services';
+export { MongoConnectionManager } from './helpers';
+export type { TopologyInfo } from './helpers';
+export { MongoConnectorError } from './connector';
+export { MongoTopologyError } from './services';
+export { MongoConnectionError } from './helpers';

package/dist/index.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MongoConnectionError = exports.MongoTopologyError = exports.MongoConnectorError = exports.MongoConnectionManager = exports.MongoServiceImpl = exports.redactUrl = exports.validateConfig = exports.MongoConfigError = exports.MongoDataSourceFactoryProvider = exports.MongoDataSourceProvider = exports.MongoDataSource = exports.initialize = exports.MongoConnector = exports.MongoBindings = exports.MongoLifecycleObserver = exports.MongoComponent = void 0;
+// Component
+var mongo_component_1 = require("./mongo.component");
+Object.defineProperty(exports, "MongoComponent", { enumerable: true, get: function () { return mongo_component_1.MongoComponent; } });
+Object.defineProperty(exports, "MongoLifecycleObserver", { enumerable: true, get: function () { return mongo_component_1.MongoLifecycleObserver; } });
+// Binding keys
+var keys_1 = require("./keys");
+Object.defineProperty(exports, "MongoBindings", { enumerable: true, get: function () { return keys_1.MongoBindings; } });
+// Connector (public: class + juggler initializer)
+var connector_1 = require("./connector");
+Object.defineProperty(exports, "MongoConnector", { enumerable: true, get: function () { return connector_1.MongoConnector; } });
+Object.defineProperty(exports, "initialize", { enumerable: true, get: function () { return connector_1.initialize; } });
+// DataSource (shared-manager juggler DataSource + provider + factory)
+var datasource_1 = require("./datasource");
+Object.defineProperty(exports, "MongoDataSource", { enumerable: true, get: function () { return datasource_1.MongoDataSource; } });
+Object.defineProperty(exports, "MongoDataSourceProvider", { enumerable: true, get: function () { return datasource_1.MongoDataSourceProvider; } });
+Object.defineProperty(exports, "MongoDataSourceFactoryProvider", { enumerable: true, get: function () { return datasource_1.MongoDataSourceFactoryProvider; } });
+// Config validation
+var helpers_1 = require("./helpers");
+Object.defineProperty(exports, "MongoConfigError", { enumerable: true, get: function () { return helpers_1.MongoConfigError; } });
+Object.defineProperty(exports, "validateConfig", { enumerable: true, get: function () { return helpers_1.validateConfig; } });
+Object.defineProperty(exports, "redactUrl", { enumerable: true, get: function () { return helpers_1.redactUrl; } });
+var services_1 = require("./services");
+Object.defineProperty(exports, "MongoServiceImpl", { enumerable: true, get: function () { return services_1.MongoServiceImpl; } });
+// Connection management
+var helpers_2 = require("./helpers");
+Object.defineProperty(exports, "MongoConnectionManager", { enumerable: true, get: function () { return helpers_2.MongoConnectionManager; } });
+// Typed error classes for instanceof matching
+var connector_2 = require("./connector");
+Object.defineProperty(exports, "MongoConnectorError", { enumerable: true, get: function () { return connector_2.MongoConnectorError; } });
+var services_2 = require("./services");
+Object.defineProperty(exports, "MongoTopologyError", { enumerable: true, get: function () { return services_2.MongoTopologyError; } });
+var helpers_3 = require("./helpers");
+Object.defineProperty(exports, "MongoConnectionError", { enumerable: true, get: function () { return helpers_3.MongoConnectionError; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,YAAY;AACZ,qDAAyE;AAAjE,iHAAA,cAAc,OAAA;AAAE,yHAAA,sBAAsB,OAAA;AAE9C,eAAe;AACf,+BAAqC;AAA7B,qGAAA,aAAa,OAAA;AAKrB,kDAAkD;AAClD,yCAAuD;AAA/C,2GAAA,cAAc,OAAA;AAAE,uGAAA,UAAU,OAAA;AAGlC,sEAAsE;AACtE,2CAIsB;AAHpB,6GAAA,eAAe,OAAA;AACf,qHAAA,uBAAuB,OAAA;AACvB,4HAAA,8BAA8B,OAAA;AAIhC,oBAAoB;AACpB,qCAAsE;AAA9D,2GAAA,gBAAgB,OAAA;AAAE,yGAAA,cAAc,OAAA;AAAE,oGAAA,SAAS,OAAA;AAInD,uCAA4C;AAApC,4GAAA,gBAAgB,OAAA;AAExB,wBAAwB;AACxB,qCAAiD;AAAzC,iHAAA,sBAAsB,OAAA;AAG9B,8CAA8C;AAC9C,yCAAgD;AAAxC,gHAAA,mBAAmB,OAAA;AAC3B,uCAA8C;AAAtC,8GAAA,kBAAkB,OAAA;AAC1B,qCAA+C;AAAvC,+GAAA,oBAAoB,OAAA"}

package/dist/keys.d.ts

@@ -0,0 +1,38 @@
+import { BindingKey } from '@loopback/core';
+import type { juggler } from '@loopback/repository';
+import type { MongoService } from './services/mongo.service';
+import type { MongoConnectorConfig } from './types';
+import type { MongoConnectionManager } from './helpers/connection-manager';
+import type { MongoDataSourceFactory } from './datasource/mongo.datasource.factory';
+/**
+ * Binding keys for the MongoDB component.
+ *
+ * @public
+ */
+export declare namespace MongoBindings {
+    /**
+     * Binding key for the shared MongoConnectionManager singleton.
+     * Owns the MongoClient and connection lifecycle.
+     */
+    const CONNECTION_MANAGER: BindingKey<MongoConnectionManager>;
+    /**
+     * Binding key for the MongoService.
+     */
+    const SERVICE: BindingKey<MongoService>;
+    /**
+     * Binding key for the connector configuration.
+     */
+    const CONFIG: BindingKey<MongoConnectorConfig>;
+    /**
+     * Binding key for the shared juggler DataSource. The connector
+     * behind it uses the shared MongoConnectionManager, so repositories
+     * and MongoService share one connection pool.
+     */
+    const DATASOURCE: BindingKey<juggler.DataSource>;
+    /**
+     * Binding key for a factory that builds MongoDataSource instances
+     * for multi-tenant or multi-database use. Each instance shares the
+     * singleton MongoConnectionManager (one MongoClient, one pool).
+     */
+    const DATASOURCE_FACTORY: BindingKey<MongoDataSourceFactory>;
+}

package/dist/keys.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MongoBindings = void 0;
+const core_1 = require("@loopback/core");
+/**
+ * Binding keys for the MongoDB component.
+ *
+ * @public
+ */
+var MongoBindings;
+(function (MongoBindings) {
+    /**
+     * Binding key for the shared MongoConnectionManager singleton.
+     * Owns the MongoClient and connection lifecycle.
+     */
+    MongoBindings.CONNECTION_MANAGER = core_1.BindingKey.create('mongo.connection-manager');
+    /**
+     * Binding key for the MongoService.
+     */
+    MongoBindings.SERVICE = core_1.BindingKey.create('mongo.service');
+    /**
+     * Binding key for the connector configuration.
+     */
+    MongoBindings.CONFIG = core_1.BindingKey.create('mongo.config');
+    /**
+     * Binding key for the shared juggler DataSource. The connector
+     * behind it uses the shared MongoConnectionManager, so repositories
+     * and MongoService share one connection pool.
+     */
+    MongoBindings.DATASOURCE = core_1.BindingKey.create('datasources.mongo');
+    /**
+     * Binding key for a factory that builds MongoDataSource instances
+     * for multi-tenant or multi-database use. Each instance shares the
+     * singleton MongoConnectionManager (one MongoClient, one pool).
+     */
+    MongoBindings.DATASOURCE_FACTORY = core_1.BindingKey.create('datasources.mongo.factory');
+})(MongoBindings || (exports.MongoBindings = MongoBindings = {}));
+//# sourceMappingURL=keys.js.map

package/dist/keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../src/keys.ts"],"names":[],"mappings":";;;AAAA,yCAA0C;AAO1C;;;;GAIG;AACH,IAAiB,aAAa,CAmC7B;AAnCD,WAAiB,aAAa;IAC5B;;;OAGG;IACU,gCAAkB,GAAG,iBAAU,CAAC,MAAM,CACjD,0BAA0B,CAC3B,CAAC;IAEF;;OAEG;IACU,qBAAO,GAAG,iBAAU,CAAC,MAAM,CAAe,eAAe,CAAC,CAAC;IAExE;;OAEG;IACU,oBAAM,GAAG,iBAAU,CAAC,MAAM,CAAuB,cAAc,CAAC,CAAC;IAE9E;;;;OAIG;IACU,wBAAU,GACrB,iBAAU,CAAC,MAAM,CAAqB,mBAAmB,CAAC,CAAC;IAE7D;;;;OAIG;IACU,gCAAkB,GAAG,iBAAU,CAAC,MAAM,CACjD,2BAA2B,CAC5B,CAAC;AACJ,CAAC,EAnCgB,aAAa,6BAAb,aAAa,QAmC7B"}