@ebarahona/loopback-connector-mongodb 1.0.0

package/dist/connector/property-mapping.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toDatabase = toDatabase;
+exports.fromDatabase = fromDatabase;
+exports.getDatabaseColumnName = getDatabaseColumnName;
+exports.getIdPropertyName = getIdPropertyName;
+const mongodb_1 = require("mongodb");
+const coercion_1 = require("./coercion");
+/**
+ * Convert a model instance to its database representation.
+ * Handles:
+ * - Custom field name mappings (property.mongodb.fieldName)
+ * - GeoPoint to GeoJSON conversion
+ * - Decimal128 coercion
+ *
+ * @param modelDef - The model definition
+ * @param data - The data to convert
+ */
+function toDatabase(modelDef, data) {
+    if (!modelDef)
+        return data;
+    const result = {};
+    const props = modelDef.properties;
+    for (const [key, value] of Object.entries(data)) {
+        const prop = props[key];
+        const dbName = prop?.mongodb?.fieldName ?? key;
+        if (prop?.mongodb?.dataType === 'Decimal128' && value != null) {
+            result[dbName] = (0, coercion_1.toDecimal128)(value);
+        }
+        else if (prop?.mongodb?.dataType === 'ObjectId' && value != null) {
+            result[dbName] = (0, coercion_1.toObjectId)(value);
+        }
+        else {
+            result[dbName] = value;
+        }
+    }
+    return result;
+}
+/**
+ * Convert a database document to a model instance.
+ * Handles:
+ * - Custom field name mappings (reverse)
+ * - Binary to Buffer conversion
+ * - Decimal128 to number conversion
+ * - ObjectId to string conversion for non-ObjectId properties
+ *
+ * @param modelDef - The model definition
+ * @param data - The database document
+ */
+function fromDatabase(modelDef, data) {
+    if (!modelDef || !data)
+        return data;
+    const result = {};
+    const props = modelDef.properties;
+    // Build reverse field name mapping
+    const reverseMap = new Map();
+    for (const [propName, prop] of Object.entries(props)) {
+        const dbName = prop?.mongodb?.fieldName;
+        if (dbName) {
+            reverseMap.set(dbName, propName);
+        }
+    }
+    for (const [key, value] of Object.entries(data)) {
+        const propName = reverseMap.get(key) ?? key;
+        const prop = props[propName];
+        if (value instanceof mongodb_1.Binary) {
+            result[propName] = value.buffer;
+        }
+        else if (value instanceof mongodb_1.Decimal128) {
+            result[propName] = parseFloat(value.toString());
+        }
+        else if (value instanceof mongodb_1.ObjectId && prop && !isObjectIdProperty(prop)) {
+            result[propName] = value.toHexString();
+        }
+        else {
+            result[propName] = value;
+        }
+    }
+    return result;
+}
+/**
+ * Get the database column name for a model property.
+ */
+function getDatabaseColumnName(modelDef, propertyName) {
+    if (!modelDef)
+        return propertyName;
+    const prop = modelDef.properties[propertyName];
+    return prop?.mongodb?.fieldName ?? propertyName;
+}
+/**
+ * Get the ID property name for a model.
+ */
+function getIdPropertyName(modelDef) {
+    if (!modelDef)
+        return 'id';
+    for (const [name, prop] of Object.entries(modelDef.properties)) {
+        if (prop.id)
+            return name;
+    }
+    return 'id';
+}
+function isObjectIdProperty(prop) {
+    return prop?.mongodb?.dataType === 'ObjectId';
+}
+//# sourceMappingURL=property-mapping.js.map

package/dist/connector/property-mapping.js.map

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

package/dist/connector/query-builder.d.ts

@@ -0,0 +1,42 @@
+import type { Document, Filter, Sort } from 'mongodb';
+/**
+ * Convert a LoopBack where filter to a MongoDB query document.
+ *
+ * Supports:
+ * - Simple equality: `{name: 'test'}`
+ * - Comparison operators: gt, gte, lt, lte, neq, between
+ * - Array operators: inq, nin
+ * - String operators: like, nlike, regexp
+ * - Logical operators: and, or, nor
+ * - Existence: exists
+ * - Null type matching
+ *
+ * Performance note: `like` and `regexp` build MongoDB `$regex`
+ * queries. Unanchored patterns (no leading `^`) cause a full
+ * collection scan unless backed by a text index. Use `inq` /
+ * exact-match where possible.
+ *
+ * @param where - LoopBack where filter
+ * @param idName - The model's ID property name (mapped to _id)
+ */
+export declare function buildWhere(where: Record<string, unknown> | undefined, idName?: string): Filter<Document>;
+/**
+ * Convert a LoopBack order specification to a MongoDB sort document.
+ *
+ * @param order - LoopBack order string or array
+ *   - 'name ASC'
+ *   - 'name DESC'
+ *   - ['name ASC', 'date DESC']
+ * @param idName - The model's ID property name
+ */
+export declare function buildSort(order: string | string[] | undefined, idName?: string): Sort | undefined;
+/**
+ * Convert a LoopBack fields filter to a MongoDB projection.
+ *
+ * @param fields - LoopBack fields specification
+ *   - `['name', 'email']` (include only)
+ *   - `{name: true, email: true}` (include)
+ *   - `{password: false}` (exclude)
+ * @param idName - The model's ID property name
+ */
+export declare function buildFields(fields: string[] | Record<string, boolean> | undefined, idName?: string): Document | undefined;

package/dist/connector/query-builder.js

@@ -0,0 +1,204 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildWhere = buildWhere;
+exports.buildSort = buildSort;
+exports.buildFields = buildFields;
+const coercion_1 = require("./coercion");
+const errors_1 = require("./errors");
+/**
+ * Convert a LoopBack where filter to a MongoDB query document.
+ *
+ * Supports:
+ * - Simple equality: `{name: 'test'}`
+ * - Comparison operators: gt, gte, lt, lte, neq, between
+ * - Array operators: inq, nin
+ * - String operators: like, nlike, regexp
+ * - Logical operators: and, or, nor
+ * - Existence: exists
+ * - Null type matching
+ *
+ * Performance note: `like` and `regexp` build MongoDB `$regex`
+ * queries. Unanchored patterns (no leading `^`) cause a full
+ * collection scan unless backed by a text index. Use `inq` /
+ * exact-match where possible.
+ *
+ * @param where - LoopBack where filter
+ * @param idName - The model's ID property name (mapped to _id)
+ */
+function buildWhere(where, idName = 'id') {
+    if (!where)
+        return {};
+    const query = {};
+    for (const [key, value] of Object.entries(where)) {
+        // Logical operators
+        if (key === 'and' || key === 'or' || key === 'nor') {
+            if (!Array.isArray(value)) {
+                throw new errors_1.MongoConnectorError(`"${key}" operator requires an array`);
+            }
+            const conditions = value;
+            query[`$${key}`] = conditions.map(c => buildWhere(c, idName));
+            continue;
+        }
+        // Map id property to _id
+        const fieldName = key === idName ? '_id' : key;
+        if (value === null || value === undefined) {
+            query[fieldName] = null;
+            continue;
+        }
+        if (typeof value !== 'object' || value instanceof Date) {
+            // Simple equality
+            query[fieldName] = fieldName === '_id' ? (0, coercion_1.toObjectId)(value) : value;
+            continue;
+        }
+        // Operator expressions
+        const spec = value;
+        const mongoExpr = {};
+        let hasOperator = false;
+        let allKeysAreOperators = true;
+        for (const [op, operand] of Object.entries(spec)) {
+            let matched = true;
+            switch (op) {
+                case 'gt':
+                    mongoExpr.$gt = fieldName === '_id' ? (0, coercion_1.toObjectId)(operand) : operand;
+                    break;
+                case 'gte':
+                    mongoExpr.$gte = fieldName === '_id' ? (0, coercion_1.toObjectId)(operand) : operand;
+                    break;
+                case 'lt':
+                    mongoExpr.$lt = fieldName === '_id' ? (0, coercion_1.toObjectId)(operand) : operand;
+                    break;
+                case 'lte':
+                    mongoExpr.$lte = fieldName === '_id' ? (0, coercion_1.toObjectId)(operand) : operand;
+                    break;
+                case 'neq':
+                    mongoExpr.$ne = fieldName === '_id' ? (0, coercion_1.toObjectId)(operand) : operand;
+                    break;
+                case 'between':
+                    if (!Array.isArray(operand) || operand.length !== 2) {
+                        throw new errors_1.MongoConnectorError(`"between" operator requires a 2-element array, got: ${JSON.stringify(operand)}`);
+                    }
+                    mongoExpr.$gte = operand[0];
+                    mongoExpr.$lte = operand[1];
+                    break;
+                case 'inq':
+                    mongoExpr.$in = Array.isArray(operand)
+                        ? operand.map(v => (fieldName === '_id' ? (0, coercion_1.toObjectId)(v) : v))
+                        : operand;
+                    break;
+                case 'nin':
+                    mongoExpr.$nin = Array.isArray(operand)
+                        ? operand.map(v => (fieldName === '_id' ? (0, coercion_1.toObjectId)(v) : v))
+                        : operand;
+                    break;
+                case 'like':
+                    mongoExpr.$regex = new RegExp(escapeRegex(String(operand)));
+                    break;
+                case 'nlike':
+                    mongoExpr.$not = new RegExp(escapeRegex(String(operand)));
+                    break;
+                case 'regexp':
+                    if (operand instanceof RegExp) {
+                        mongoExpr.$regex = operand;
+                    }
+                    else if (typeof operand === 'string' && operand.length <= 256) {
+                        // Hard cap on pattern length to bound RegExp compilation cost.
+                        // Callers wanting arbitrary patterns should pass a real RegExp.
+                        mongoExpr.$regex = new RegExp(operand);
+                    }
+                    else {
+                        throw new errors_1.MongoConnectorError(`"regexp" operator requires a RegExp instance or a string ≤ 256 chars; got: ${typeof operand}`);
+                    }
+                    break;
+                case 'exists':
+                    mongoExpr.$exists = Boolean(operand);
+                    break;
+                default:
+                    if (op.startsWith('$')) {
+                        // Pass through native operators (e.g. $elemMatch, $size)
+                        mongoExpr[op] = operand;
+                    }
+                    else {
+                        matched = false;
+                    }
+                    break;
+            }
+            if (matched) {
+                hasOperator = true;
+            }
+            else {
+                allKeysAreOperators = false;
+            }
+        }
+        if (hasOperator && allKeysAreOperators) {
+            query[fieldName] = mongoExpr;
+        }
+        else {
+            // Plain object value (equality match). Includes the
+            // mixed case where some keys look like operators but
+            // others do not -- safer to treat as a literal match
+            // than to silently drop the non-operator keys.
+            query[fieldName] = fieldName === '_id' ? (0, coercion_1.toObjectId)(value) : value;
+        }
+    }
+    return query;
+}
+/**
+ * Convert a LoopBack order specification to a MongoDB sort document.
+ *
+ * @param order - LoopBack order string or array
+ *   - 'name ASC'
+ *   - 'name DESC'
+ *   - ['name ASC', 'date DESC']
+ * @param idName - The model's ID property name
+ */
+function buildSort(order, idName = 'id') {
+    if (!order)
+        return undefined;
+    const orders = Array.isArray(order) ? order : [order];
+    const sort = {};
+    for (const item of orders) {
+        const parts = item.trim().split(/\s+/);
+        let field = parts[0];
+        const direction = parts[1]?.toUpperCase() === 'DESC' ? -1 : 1;
+        if (field === idName)
+            field = '_id';
+        sort[field] = direction;
+    }
+    return sort;
+}
+/**
+ * Convert a LoopBack fields filter to a MongoDB projection.
+ *
+ * @param fields - LoopBack fields specification
+ *   - `['name', 'email']` (include only)
+ *   - `{name: true, email: true}` (include)
+ *   - `{password: false}` (exclude)
+ * @param idName - The model's ID property name
+ */
+function buildFields(fields, idName = 'id') {
+    if (!fields)
+        return undefined;
+    const projection = {};
+    if (Array.isArray(fields)) {
+        for (let field of fields) {
+            if (field === idName)
+                field = '_id';
+            projection[field] = 1;
+        }
+    }
+    else {
+        for (let [field, include] of Object.entries(fields)) {
+            if (field === idName)
+                field = '_id';
+            projection[field] = include ? 1 : 0;
+        }
+    }
+    return projection;
+}
+/**
+ * Escape special regex characters in a string.
+ */
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+//# sourceMappingURL=query-builder.js.map

package/dist/connector/query-builder.js.map

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

package/dist/datasource/index.d.ts

@@ -0,0 +1,3 @@
+export { MongoDataSource } from './mongo.datasource';
+export { MongoDataSourceProvider } from './mongo.datasource.provider';
+export { MongoDataSourceFactory, MongoDataSourceFactoryProvider, } from './mongo.datasource.factory';

package/dist/datasource/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MongoDataSourceFactoryProvider = exports.MongoDataSourceProvider = exports.MongoDataSource = void 0;
+var mongo_datasource_1 = require("./mongo.datasource");
+Object.defineProperty(exports, "MongoDataSource", { enumerable: true, get: function () { return mongo_datasource_1.MongoDataSource; } });
+var mongo_datasource_provider_1 = require("./mongo.datasource.provider");
+Object.defineProperty(exports, "MongoDataSourceProvider", { enumerable: true, get: function () { return mongo_datasource_provider_1.MongoDataSourceProvider; } });
+var mongo_datasource_factory_1 = require("./mongo.datasource.factory");
+Object.defineProperty(exports, "MongoDataSourceFactoryProvider", { enumerable: true, get: function () { return mongo_datasource_factory_1.MongoDataSourceFactoryProvider; } });
+//# sourceMappingURL=index.js.map

package/dist/datasource/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/datasource/index.ts"],"names":[],"mappings":";;;AAAA,uDAAmD;AAA3C,mHAAA,eAAe,OAAA;AACvB,yEAAoE;AAA5D,oIAAA,uBAAuB,OAAA;AAC/B,uEAGoC;AADlC,0IAAA,8BAA8B,OAAA"}

package/dist/datasource/mongo.datasource.d.ts

@@ -0,0 +1,17 @@
+import { juggler } from '@loopback/repository';
+import type { MongoConnectionManager } from '../helpers/connection-manager';
+import type { MongoConnectorConfig } from '../types';
+/**
+ * A juggler DataSource whose underlying connector uses a shared
+ * MongoConnectionManager. Repositories built on this DataSource
+ * share one connection pool with MongoService.
+ *
+ * Lifecycle is owned by the shared manager (MongoComponent's
+ * lifecycle observer). Calling `disconnect()` on the underlying
+ * connector is a no-op.
+ *
+ * @public
+ */
+export declare class MongoDataSource extends juggler.DataSource {
+    constructor(config: MongoConnectorConfig, connectionManager: MongoConnectionManager);
+}

package/dist/datasource/mongo.datasource.factory.d.ts

@@ -0,0 +1,30 @@
+import { Provider } from '@loopback/core';
+import { juggler } from '@loopback/repository';
+import { MongoConnectionManager } from '../helpers/connection-manager';
+import { MongoConnectorConfig } from '../types';
+/**
+ * Factory for building per-tenant or per-database MongoDataSources
+ * that share the singleton MongoConnectionManager (one MongoClient,
+ * one pool).
+ *
+ * Pass `{database: 'tenant_42'}` (or any other override) to target
+ * a different database on the same cluster without opening a new
+ * connection. Useful for multi-tenant deployments where each tenant
+ * gets its own database.
+ *
+ * @public
+ */
+export type MongoDataSourceFactory = (override?: Partial<MongoConnectorConfig>) => juggler.DataSource;
+/**
+ * Provider that yields a MongoDataSourceFactory bound at
+ * `MongoBindings.DATASOURCE_FACTORY`. Each call constructs a new
+ * MongoDataSource wired to the shared MongoConnectionManager.
+ *
+ * @public
+ */
+export declare class MongoDataSourceFactoryProvider implements Provider<MongoDataSourceFactory> {
+    private config;
+    private manager;
+    constructor(config: MongoConnectorConfig | undefined, manager: MongoConnectionManager);
+    value(): MongoDataSourceFactory;
+}

package/dist/datasource/mongo.datasource.factory.js

@@ -0,0 +1,44 @@
+"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); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MongoDataSourceFactoryProvider = void 0;
+const core_1 = require("@loopback/core");
+const keys_1 = require("../keys");
+const connection_manager_1 = require("../helpers/connection-manager");
+const mongo_datasource_1 = require("./mongo.datasource");
+/**
+ * Provider that yields a MongoDataSourceFactory bound at
+ * `MongoBindings.DATASOURCE_FACTORY`. Each call constructs a new
+ * MongoDataSource wired to the shared MongoConnectionManager.
+ *
+ * @public
+ */
+let MongoDataSourceFactoryProvider = class MongoDataSourceFactoryProvider {
+    constructor(config, manager) {
+        this.config = config;
+        this.manager = manager;
+    }
+    value() {
+        const base = this.config ?? {};
+        const manager = this.manager;
+        return (override) => new mongo_datasource_1.MongoDataSource({ ...base, ...(override ?? {}) }, manager);
+    }
+};
+exports.MongoDataSourceFactoryProvider = MongoDataSourceFactoryProvider;
+exports.MongoDataSourceFactoryProvider = MongoDataSourceFactoryProvider = __decorate([
+    __param(0, (0, core_1.inject)(keys_1.MongoBindings.CONFIG, { optional: true })),
+    __param(1, (0, core_1.inject)(keys_1.MongoBindings.CONNECTION_MANAGER)),
+    __metadata("design:paramtypes", [Object, connection_manager_1.MongoConnectionManager])
+], MongoDataSourceFactoryProvider);
+//# sourceMappingURL=mongo.datasource.factory.js.map

package/dist/datasource/mongo.datasource.factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongo.datasource.factory.js","sourceRoot":"","sources":["../../src/datasource/mongo.datasource.factory.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,yCAAgD;AAEhD,kCAAsC;AACtC,sEAAqE;AAErE,yDAAmD;AAkBnD;;;;;;GAMG;AACH,IAAa,8BAA8B,GAA3C,MAAa,8BAA8B;IACzC,YAEU,MAAwC,EAExC,OAA+B;QAF/B,WAAM,GAAN,MAAM,CAAkC;QAExC,YAAO,GAAP,OAAO,CAAwB;IACtC,CAAC;IAEJ,KAAK;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC;QAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC7B,OAAO,CAAC,QAAwC,EAAE,EAAE,CAClD,IAAI,kCAAe,CAAC,EAAC,GAAG,IAAI,EAAE,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAC,EAAE,OAAO,CAAC,CAAC;IACjE,CAAC;CACF,CAAA;AAdY,wEAA8B;yCAA9B,8BAA8B;IAEtC,WAAA,IAAA,aAAM,EAAC,oBAAa,CAAC,MAAM,EAAE,EAAC,QAAQ,EAAE,IAAI,EAAC,CAAC,CAAA;IAE9C,WAAA,IAAA,aAAM,EAAC,oBAAa,CAAC,kBAAkB,CAAC,CAAA;6CACxB,2CAAsB;GAL9B,8BAA8B,CAc1C"}

package/dist/datasource/mongo.datasource.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MongoDataSource = void 0;
+const repository_1 = require("@loopback/repository");
+const mongodb_1 = require("mongodb");
+const mongo_connector_1 = require("../connector/mongo.connector");
+/**
+ * A juggler DataSource whose underlying connector uses a shared
+ * MongoConnectionManager. Repositories built on this DataSource
+ * share one connection pool with MongoService.
+ *
+ * Lifecycle is owned by the shared manager (MongoComponent's
+ * lifecycle observer). Calling `disconnect()` on the underlying
+ * connector is a no-op.
+ *
+ * @public
+ */
+class MongoDataSource extends repository_1.juggler.DataSource {
+    constructor(config, connectionManager) {
+        const connector = new mongo_connector_1.MongoConnector(config, connectionManager);
+        super({
+            name: 'mongo',
+            ...config,
+            connector,
+        });
+        // juggler.DataSource only assigns `this.connector` when it
+        // resolves the connector via an initialize() module. We pass
+        // a fully constructed connector instance, so wire it directly.
+        this.connector = connector;
+        connector.dataSource = this;
+        this.ObjectID = mongodb_1.ObjectId;
+        // The shared MongoConnectionManager owns the real connection.
+        // Tell the juggler this DataSource is already connected so
+        // repository operations don't hang waiting for juggler's own
+        // connect flow.
+        this.connected = true;
+    }
+}
+exports.MongoDataSource = MongoDataSource;
+//# sourceMappingURL=mongo.datasource.js.map

package/dist/datasource/mongo.datasource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongo.datasource.js","sourceRoot":"","sources":["../../src/datasource/mongo.datasource.ts"],"names":[],"mappings":";;;AAAA,qDAA6C;AAC7C,qCAAiC;AACjC,kEAA4D;AAI5D;;;;;;;;;;GAUG;AACH,MAAa,eAAgB,SAAQ,oBAAO,CAAC,UAAU;IACrD,YACE,MAA4B,EAC5B,iBAAyC;QAEzC,MAAM,SAAS,GAAG,IAAI,gCAAc,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;QAChE,KAAK,CAAC;YACJ,IAAI,EAAE,OAAO;YACb,GAAG,MAAM;YACT,SAAS;SACV,CAAC,CAAC;QACH,2DAA2D;QAC3D,6DAA6D;QAC7D,+DAA+D;QAC9D,IAA+C,CAAC,SAAS,GAAG,SAAS,CAAC;QACvE,SAAS,CAAC,UAAU,GAAG,IAA0C,CAAC;QACjE,IAA2C,CAAC,QAAQ,GAAG,kBAAQ,CAAC;QAEjE,8DAA8D;QAC9D,2DAA2D;QAC3D,6DAA6D;QAC7D,gBAAgB;QACf,IAAwC,CAAC,SAAS,GAAG,IAAI,CAAC;IAC7D,CAAC;CACF;AAxBD,0CAwBC"}

package/dist/datasource/mongo.datasource.provider.d.ts

@@ -0,0 +1,17 @@
+import { Provider } from '@loopback/core';
+import { juggler } from '@loopback/repository';
+import { MongoConnectionManager } from '../helpers/connection-manager';
+import { MongoConnectorConfig } from '../types';
+/**
+ * Provider that yields a singleton MongoDataSource wired to the
+ * shared MongoConnectionManager. Bound by MongoComponent at
+ * MongoBindings.DATASOURCE.
+ *
+ * @public
+ */
+export declare class MongoDataSourceProvider implements Provider<juggler.DataSource> {
+    private config;
+    private manager;
+    constructor(config: MongoConnectorConfig | undefined, manager: MongoConnectionManager);
+    value(): juggler.DataSource;
+}

package/dist/datasource/mongo.datasource.provider.js

@@ -0,0 +1,42 @@
+"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); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MongoDataSourceProvider = void 0;
+const core_1 = require("@loopback/core");
+const keys_1 = require("../keys");
+const connection_manager_1 = require("../helpers/connection-manager");
+const mongo_datasource_1 = require("./mongo.datasource");
+/**
+ * Provider that yields a singleton MongoDataSource wired to the
+ * shared MongoConnectionManager. Bound by MongoComponent at
+ * MongoBindings.DATASOURCE.
+ *
+ * @public
+ */
+let MongoDataSourceProvider = class MongoDataSourceProvider {
+    constructor(config, manager) {
+        this.config = config;
+        this.manager = manager;
+    }
+    value() {
+        return new mongo_datasource_1.MongoDataSource(this.config ?? {}, this.manager);
+    }
+};
+exports.MongoDataSourceProvider = MongoDataSourceProvider;
+exports.MongoDataSourceProvider = MongoDataSourceProvider = __decorate([
+    __param(0, (0, core_1.inject)(keys_1.MongoBindings.CONFIG, { optional: true })),
+    __param(1, (0, core_1.inject)(keys_1.MongoBindings.CONNECTION_MANAGER)),
+    __metadata("design:paramtypes", [Object, connection_manager_1.MongoConnectionManager])
+], MongoDataSourceProvider);
+//# sourceMappingURL=mongo.datasource.provider.js.map

package/dist/datasource/mongo.datasource.provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongo.datasource.provider.js","sourceRoot":"","sources":["../../src/datasource/mongo.datasource.provider.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,yCAAgD;AAEhD,kCAAsC;AACtC,sEAAqE;AAErE,yDAAmD;AAEnD;;;;;;GAMG;AACH,IAAa,uBAAuB,GAApC,MAAa,uBAAuB;IAClC,YAEU,MAAwC,EAExC,OAA+B;QAF/B,WAAM,GAAN,MAAM,CAAkC;QAExC,YAAO,GAAP,OAAO,CAAwB;IACtC,CAAC;IAEJ,KAAK;QACH,OAAO,IAAI,kCAAe,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9D,CAAC;CACF,CAAA;AAXY,0DAAuB;kCAAvB,uBAAuB;IAE/B,WAAA,IAAA,aAAM,EAAC,oBAAa,CAAC,MAAM,EAAE,EAAC,QAAQ,EAAE,IAAI,EAAC,CAAC,CAAA;IAE9C,WAAA,IAAA,aAAM,EAAC,oBAAa,CAAC,kBAAkB,CAAC,CAAA;6CACxB,2CAAsB;GAL9B,uBAAuB,CAWnC"}

package/dist/helpers/config-validator.d.ts

@@ -0,0 +1,34 @@
+import type { MongoConnectorConfig } from '../types';
+/**
+ * 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
+ */
+export declare class MongoConfigError extends Error {
+    readonly name = "MongoConfigError";
+    constructor(message: string);
+}
+/**
+ * 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
+ */
+export declare function validateConfig(config: MongoConnectorConfig | undefined): void;
+/**
+ * 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
+ */
+export declare function redactUrl(url: string): string;