typeorm
Version:
Data-Mapper ORM for TypeScript and ES2023+. Supports MySQL/MariaDB, PostgreSQL, MS SQL Server, Oracle, SAP HANA, SQLite, MongoDB databases.
446 lines • 15.3 kB
JavaScript
;
Object.defineProperty(exports, "__esModule", { value: true });
exports.MongoDriver = void 0;
const error_1 = require("../../error");
const ConnectionIsNotSetError_1 = require("../../error/ConnectionIsNotSetError");
const DriverPackageNotInstalledError_1 = require("../../error/DriverPackageNotInstalledError");
const PlatformTools_1 = require("../../platform/PlatformTools");
const MongoSchemaBuilder_1 = require("../../schema-builder/MongoSchemaBuilder");
const ApplyValueTransformers_1 = require("../../util/ApplyValueTransformers");
const InstanceChecker_1 = require("../../util/InstanceChecker");
const ObjectUtils_1 = require("../../util/ObjectUtils");
const DriverUtils_1 = require("../DriverUtils");
const MongoQueryRunner_1 = require("./MongoQueryRunner");
/**
* Organizes communication with MongoDB.
*/
class MongoDriver {
// -------------------------------------------------------------------------
// Static Properties
// -------------------------------------------------------------------------
/**
* Transaction isolation levels supported by this driver.
*/
static { this.supportedIsolationLevels = []; }
// -------------------------------------------------------------------------
// Constructor
// -------------------------------------------------------------------------
constructor(dataSource) {
this.dataSource = dataSource;
// -------------------------------------------------------------------------
// Public Properties
// -------------------------------------------------------------------------
/**
* Isolation levels supported by this driver.
*/
this.supportedIsolationLevels = MongoDriver.supportedIsolationLevels;
/**
* Indicates if replication is enabled.
*/
this.isReplicated = false;
/**
* Indicates if tree tables are supported by this driver.
*/
this.treeSupport = false;
/**
* Represent transaction support by this driver
*/
this.transactionSupport = "none";
/**
* Mongodb does not need to have column types because they are not used in schema sync.
*/
this.supportedDataTypes = [];
/**
* Gets list of spatial column data types.
*/
this.spatialTypes = [];
/**
* Gets list of column data types that support length by a driver.
*/
this.withLengthColumnTypes = [];
/**
* Gets list of column data types that support precision by a driver.
*/
this.withPrecisionColumnTypes = [];
/**
* Gets list of column data types that support scale by a driver.
*/
this.withScaleColumnTypes = [];
/**
* Mongodb does not need to have a strong defined mapped column types because they are not used in schema sync.
*/
this.mappedDataTypes = {
createDate: "int",
createDateDefault: "",
updateDate: "int",
updateDateDefault: "",
deleteDate: "int",
deleteDateNullable: true,
version: "int",
treeLevel: "int",
migrationId: "int",
migrationName: "int",
migrationTimestamp: "int",
cacheId: "int",
cacheIdentifier: "int",
cacheTime: "int",
cacheDuration: "int",
cacheQuery: "int",
cacheResult: "int",
metadataType: "int",
metadataDatabase: "int",
metadataSchema: "int",
metadataTable: "int",
metadataName: "int",
metadataValue: "int",
};
this.cteCapabilities = {
enabled: false,
};
// -------------------------------------------------------------------------
// Protected Properties
// -------------------------------------------------------------------------
/**
* Valid mongo connection options
* NOTE: Keep in sync with MongoConnectionOptions
*/
this.validOptionNames = [
"appName",
"authMechanism",
"authSource",
"autoEncryption",
"checkServerIdentity",
"compressors",
"connectTimeoutMS",
"directConnection",
"family",
"forceServerObjectId",
"ignoreUndefined",
"localThresholdMS",
"maxStalenessSeconds",
"minPoolSize",
"monitorCommands",
"noDelay",
"pkFactory",
"promoteBuffers",
"promoteLongs",
"promoteValues",
"raw",
"readConcern",
"readPreference",
"readPreferenceTags",
"replicaSet",
"retryWrites",
"serializeFunctions",
"socketTimeoutMS",
"tls",
"tlsAllowInvalidCertificates",
"tlsCAFile",
"tlsCertificateKeyFile",
"tlsCertificateKeyFilePassword",
"writeConcern",
// Proxy configuration for Socks5
"proxyHost",
"proxyPort",
"proxyUsername",
"proxyPassword",
];
this.options = dataSource.options;
// validate options to make sure everything is correct and driver will be able to establish connection
this.validateOptions(dataSource.options);
// load mongodb package
this.loadDependencies();
this.database = DriverUtils_1.DriverUtils.buildMongoDBDriverOptions(this.options).database;
}
// -------------------------------------------------------------------------
// Public Methods
// -------------------------------------------------------------------------
/**
* Performs connection to the database.
*/
async connect() {
const options = DriverUtils_1.DriverUtils.buildMongoDBDriverOptions(this.options);
const client = await this.mongodb.MongoClient.connect(this.buildConnectionUrl(options), this.buildConnectionOptions(options));
this.queryRunner = new MongoQueryRunner_1.MongoQueryRunner(this.dataSource, client);
ObjectUtils_1.ObjectUtils.assign(this.queryRunner, {
manager: this.dataSource.manager,
});
}
afterConnect() {
return Promise.resolve();
}
/**
* Closes connection with the database.
*/
async disconnect() {
const queryRunner = this.queryRunner;
if (!queryRunner) {
throw new ConnectionIsNotSetError_1.ConnectionIsNotSetError("mongodb");
}
this.queryRunner = undefined;
await queryRunner.databaseConnection.close();
}
/**
* Creates a schema builder used to build and sync a schema.
*/
createSchemaBuilder() {
return new MongoSchemaBuilder_1.MongoSchemaBuilder(this.dataSource);
}
/**
* Creates a query runner used to execute database queries.
*
* @param mode
*/
createQueryRunner(mode) {
return this.queryRunner;
}
/**
* Replaces parameters in the given sql with special escaping character
* and an array of parameter names to be passed to a query.
*
* @param sql
* @param parameters
*/
escapeQueryWithParameters(sql, parameters) {
throw new error_1.TypeORMError(`This operation is not supported by Mongodb driver.`);
}
/**
* Escapes a column name.
*
* @param columnName
*/
escape(columnName) {
return columnName;
}
/**
* Build full table name with database name, schema name and table name.
* E.g. myDB.mySchema.myTable
*
* @param tableName
* @param schema
* @param database
*/
buildTableName(tableName, schema, database) {
return tableName;
}
/**
* Parse a target table name or other types and return a normalized table definition.
*
* @param target
*/
parseTableName(target) {
if (InstanceChecker_1.InstanceChecker.isEntityMetadata(target)) {
return {
tableName: target.tableName,
};
}
if (InstanceChecker_1.InstanceChecker.isTable(target) || InstanceChecker_1.InstanceChecker.isView(target)) {
return {
tableName: target.name,
};
}
if (InstanceChecker_1.InstanceChecker.isTableForeignKey(target)) {
return {
tableName: target.referencedTableName,
};
}
return {
tableName: target,
};
}
/**
* Prepares given value to a value to be persisted, based on its column type and metadata.
*
* @param value
* @param columnMetadata
*/
preparePersistentValue(value, columnMetadata) {
if (columnMetadata.transformer)
value = ApplyValueTransformers_1.ApplyValueTransformers.transformTo(columnMetadata.transformer, value);
return value;
}
/**
* Prepares given value to a value to be persisted, based on its column type or metadata.
*
* @param value
* @param columnMetadata
*/
prepareHydratedValue(value, columnMetadata) {
if (columnMetadata.transformer)
value = ApplyValueTransformers_1.ApplyValueTransformers.transformFrom(columnMetadata.transformer, value);
return value;
}
/**
* Creates a database type from a given column metadata.
*
* @param column
* @param column.type
* @param column.length
* @param column.precision
* @param column.scale
*/
normalizeType(column) {
throw new error_1.TypeORMError(`MongoDB is schema-less, not supported by this driver.`);
}
/**
* Normalizes "default" value of the column.
*
* @param columnMetadata
*/
normalizeDefault(columnMetadata) {
throw new error_1.TypeORMError(`MongoDB is schema-less, not supported by this driver.`);
}
/**
* Normalizes "isUnique" value of the column.
*
* @param column
*/
normalizeIsUnique(column) {
throw new error_1.TypeORMError(`MongoDB is schema-less, not supported by this driver.`);
}
/**
* Calculates column length taking into account the default length values.
*
* @param column
*/
getColumnLength(column) {
throw new error_1.TypeORMError(`MongoDB is schema-less, not supported by this driver.`);
}
/**
* Normalizes "default" value of the column.
*
* @param column
*/
createFullType(column) {
throw new error_1.TypeORMError(`MongoDB is schema-less, not supported by this driver.`);
}
/**
* Obtains a new database connection to a master server.
* Used for replication.
* If replication is not setup then returns default connection's database connection.
*/
obtainMasterConnection() {
return Promise.resolve();
}
/**
* Obtains a new database connection to a slave server.
* Used for replication.
* If replication is not setup then returns master (default) connection's database connection.
*/
obtainSlaveConnection() {
return Promise.resolve();
}
/**
* Creates generated map of values generated or returned by database after INSERT query.
*
* @param metadata
* @param insertedId
*/
createGeneratedMap(metadata, insertedId) {
return metadata.objectIdColumn.createValueMap(insertedId);
}
/**
* Differentiate columns of this table and columns from the given column metadatas columns
* and returns only changed.
*
* @param tableColumns
* @param columnMetadatas
*/
findChangedColumns(tableColumns, columnMetadatas) {
throw new error_1.TypeORMError(`MongoDB is schema-less, not supported by this driver.`);
}
/**
* Returns true if driver supports RETURNING / OUTPUT statement.
*/
isReturningSqlSupported() {
return false;
}
/**
* Returns true if driver supports uuid values generation on its own.
*/
isUUIDGenerationSupported() {
return false;
}
/**
* Returns true if driver supports fulltext indices.
*/
isFullTextColumnTypeSupported() {
return false;
}
/**
* Creates an escaped parameter.
*
* @param parameterName
* @param index
*/
createParameter(parameterName, index) {
return "";
}
// -------------------------------------------------------------------------
// Protected Methods
// -------------------------------------------------------------------------
/**
* Validate driver options to make sure everything is correct and driver will be able to establish connection.
*
* @param options
*/
validateOptions(options) {
// todo: fix
// if (!options.url) {
// if (!options.database)
// throw new DriverOptionNotSetError("database");
// }
}
/**
* Loads all driver dependencies.
*/
loadDependencies() {
try {
const mongodb = this.options.driver ?? PlatformTools_1.PlatformTools.load("mongodb");
this.mongodb = mongodb;
}
catch (e) {
throw new DriverPackageNotInstalledError_1.DriverPackageNotInstalledError("MongoDB", "mongodb");
}
}
/**
* Builds connection url that is passed to underlying driver to perform connection to the mongodb database.
*/
buildConnectionUrl(options) {
const schemaUrlPart = options.type.toLowerCase();
const credentialsUrlPart = options.username && options.password
? `${encodeURIComponent(options.username)}:${encodeURIComponent(options.password)}@`
: "";
const portUrlPart = schemaUrlPart === "mongodb+srv" ? "" : `:${options.port ?? "27017"}`;
let connectionString;
if (options.replicaSet) {
connectionString = `${schemaUrlPart}://${credentialsUrlPart}${options.hostReplicaSet ??
`${options.host ?? "127.0.0.1"}${portUrlPart}`}/${options.database ?? ""}`;
}
else {
connectionString = `${schemaUrlPart}://${credentialsUrlPart}${options.host ?? "127.0.0.1"}${portUrlPart}/${options.database ?? ""}`;
}
return connectionString;
}
/**
* Build connection options from MongoConnectionOptions
*/
buildConnectionOptions(options) {
const mongoOptions = {};
for (const optionName of this.validOptionNames) {
if (optionName in options) {
mongoOptions[optionName] = options[optionName];
}
}
mongoOptions.driverInfo = {
name: "TypeORM",
};
if ("poolSize" in options) {
mongoOptions["maxPoolSize"] = options["poolSize"];
}
Object.assign(mongoOptions, options.extra);
return mongoOptions;
}
}
exports.MongoDriver = MongoDriver;
//# sourceMappingURL=MongoDriver.js.map