@depup/typeorm 0.3.28-depup.0

package/driver/Driver.d.ts

@@ -0,0 +1,225 @@
+import { QueryRunner } from "../query-runner/QueryRunner";
+import { ColumnMetadata } from "../metadata/ColumnMetadata";
+import { ObjectLiteral } from "../common/ObjectLiteral";
+import { ColumnType } from "./types/ColumnTypes";
+import { CteCapabilities } from "./types/CteCapabilities";
+import { MappedColumnTypes } from "./types/MappedColumnTypes";
+import { SchemaBuilder } from "../schema-builder/SchemaBuilder";
+import { DataTypeDefaults } from "./types/DataTypeDefaults";
+import { BaseDataSourceOptions } from "../data-source/BaseDataSourceOptions";
+import { TableColumn } from "../schema-builder/table/TableColumn";
+import { EntityMetadata } from "../metadata/EntityMetadata";
+import { ReplicationMode } from "./types/ReplicationMode";
+import { Table } from "../schema-builder/table/Table";
+import { View } from "../schema-builder/view/View";
+import { TableForeignKey } from "../schema-builder/table/TableForeignKey";
+import { UpsertType } from "./types/UpsertType";
+import { OnDeleteType } from "../metadata/types/OnDeleteType";
+import { OnUpdateType } from "../metadata/types/OnUpdateType";
+export type ReturningType = "insert" | "update" | "delete";
+/**
+ * Driver organizes TypeORM communication with specific database management system.
+ */
+export interface Driver {
+    /**
+     * Connection options.
+     */
+    options: BaseDataSourceOptions;
+    /**
+     * Database version/release. Often requires a SQL query to the DB, so it is not always set
+     */
+    version?: string;
+    /**
+     * Database name used to perform all write queries.
+     *
+     * todo: probably move into query runner.
+     */
+    database?: string;
+    /**
+     * Schema name used to perform all write queries.
+     */
+    schema?: string;
+    /**
+     * Indicates if replication is enabled.
+     */
+    isReplicated: boolean;
+    /**
+     * Indicates if tree tables are supported by this driver.
+     */
+    treeSupport: boolean;
+    /**
+     * Represent transaction support by this driver
+     */
+    transactionSupport: "simple" | "nested" | "none";
+    /**
+     * Gets list of supported column data types by a driver.
+     */
+    supportedDataTypes: ColumnType[];
+    /**
+     * Returns type of upsert supported by driver if any
+     */
+    supportedUpsertTypes: UpsertType[];
+    /**
+     * Returns list of supported onDelete types by driver
+     */
+    supportedOnDeleteTypes?: OnDeleteType[];
+    /**
+     * Returns list of supported onUpdate types by driver
+     */
+    supportedOnUpdateTypes?: OnUpdateType[];
+    /**
+     * Default values of length, precision and scale depends on column data type.
+     * Used in the cases when length/precision/scale is not specified by user.
+     */
+    dataTypeDefaults: DataTypeDefaults;
+    /**
+     * Gets list of spatial column data types.
+     */
+    spatialTypes: ColumnType[];
+    /**
+     * Gets list of column data types that support length by a driver.
+     */
+    withLengthColumnTypes: ColumnType[];
+    /**
+     * Gets list of column data types that support precision by a driver.
+     */
+    withPrecisionColumnTypes: ColumnType[];
+    /**
+     * Gets list of column data types that support scale by a driver.
+     */
+    withScaleColumnTypes: ColumnType[];
+    /**
+     * Orm has special columns and we need to know what database column types should be for those types.
+     * Column types are driver dependant.
+     */
+    mappedDataTypes: MappedColumnTypes;
+    /**
+     * The prefix used for the parameters
+     */
+    parametersPrefix?: string;
+    /**
+     * Max length allowed by the DBMS for aliases (execution of queries).
+     */
+    maxAliasLength?: number;
+    cteCapabilities: CteCapabilities;
+    /**
+     * Dummy table name
+     */
+    dummyTableName?: string;
+    /**
+     * Performs connection to the database.
+     * Depend on driver type it may create a connection pool.
+     */
+    connect(): Promise<void>;
+    /**
+     * Makes any action after connection (e.g. create extensions in Postgres driver).
+     */
+    afterConnect(): Promise<void>;
+    /**
+     * Closes connection with database and releases all resources.
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Synchronizes database schema (creates tables, indices, etc).
+     */
+    createSchemaBuilder(): SchemaBuilder;
+    /**
+     * Creates a query runner used for common queries.
+     */
+    createQueryRunner(mode: ReplicationMode): QueryRunner;
+    /**
+     * Replaces parameters in the given sql with special escaping character
+     * and an array of parameter names to be passed to a query.
+     */
+    escapeQueryWithParameters(sql: string, parameters: ObjectLiteral, nativeParameters: ObjectLiteral): [string, any[]];
+    /**
+     * Escapes a table name, column name or an alias.
+     *
+     * todo: probably escape should be able to handle dots in the names and automatically escape them
+     */
+    escape(name: string): string;
+    /**
+     * Build full table name with database name, schema name and table name.
+     * E.g. myDB.mySchema.myTable
+     */
+    buildTableName(tableName: string, schema?: string, database?: string): string;
+    /**
+     * Parse a target table name or other types and return a normalized table definition.
+     */
+    parseTableName(target: EntityMetadata | Table | View | TableForeignKey | string): {
+        tableName: string;
+        schema?: string;
+        database?: string;
+    };
+    /**
+     * Prepares given value to a value to be persisted, based on its column type and metadata.
+     */
+    preparePersistentValue(value: any, column: ColumnMetadata): any;
+    /**
+     * Prepares given value to a value to be persisted, based on its column type.
+     */
+    prepareHydratedValue(value: any, column: ColumnMetadata): any;
+    /**
+     * Transforms type of the given column to a database column type.
+     */
+    normalizeType(column: {
+        type?: ColumnType | string;
+        length?: number | string;
+        precision?: number | null;
+        scale?: number;
+        isArray?: boolean;
+    }): string;
+    /**
+     * Normalizes "default" value of the column.
+     */
+    normalizeDefault(columnMetadata: ColumnMetadata): string | undefined;
+    /**
+     * Normalizes "isUnique" value of the column.
+     */
+    normalizeIsUnique(column: ColumnMetadata): boolean;
+    /**
+     * Calculates column length taking into account the default length values.
+     */
+    getColumnLength(column: ColumnMetadata): string;
+    /**
+     * Normalizes "default" value of the column.
+     */
+    createFullType(column: TableColumn): string;
+    /**
+     * 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(): Promise<any>;
+    /**
+     * 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(): Promise<any>;
+    /**
+     * Creates generated map of values generated or returned by database after INSERT query.
+     */
+    createGeneratedMap(metadata: EntityMetadata, insertResult: any, entityIndex?: number, entityNum?: number): ObjectLiteral | undefined;
+    /**
+     * Differentiate columns of this table and columns from the given column metadatas columns
+     * and returns only changed.
+     */
+    findChangedColumns(tableColumns: TableColumn[], columnMetadatas: ColumnMetadata[]): ColumnMetadata[];
+    /**
+     * Returns true if driver supports RETURNING / OUTPUT statement.
+     */
+    isReturningSqlSupported(returningType: ReturningType): boolean;
+    /**
+     * Returns true if driver supports uuid values generation on its own.
+     */
+    isUUIDGenerationSupported(): boolean;
+    /**
+     * Returns true if driver supports fulltext indices.
+     */
+    isFullTextColumnTypeSupported(): boolean;
+    /**
+     * Creates an escaped parameter.
+     */
+    createParameter(parameterName: string, index: number): string;
+}

package/driver/Driver.js

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

package/driver/Driver.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/driver/Driver.ts"],"names":[],"mappings":"","file":"Driver.js","sourcesContent":["import { QueryRunner } from \"../query-runner/QueryRunner\"\nimport { ColumnMetadata } from \"../metadata/ColumnMetadata\"\nimport { ObjectLiteral } from \"../common/ObjectLiteral\"\nimport { ColumnType } from \"./types/ColumnTypes\"\nimport { CteCapabilities } from \"./types/CteCapabilities\"\nimport { MappedColumnTypes } from \"./types/MappedColumnTypes\"\nimport { SchemaBuilder } from \"../schema-builder/SchemaBuilder\"\nimport { DataTypeDefaults } from \"./types/DataTypeDefaults\"\nimport { BaseDataSourceOptions } from \"../data-source/BaseDataSourceOptions\"\nimport { TableColumn } from \"../schema-builder/table/TableColumn\"\nimport { EntityMetadata } from \"../metadata/EntityMetadata\"\nimport { ReplicationMode } from \"./types/ReplicationMode\"\nimport { Table } from \"../schema-builder/table/Table\"\nimport { View } from \"../schema-builder/view/View\"\nimport { TableForeignKey } from \"../schema-builder/table/TableForeignKey\"\nimport { UpsertType } from \"./types/UpsertType\"\nimport { OnDeleteType } from \"../metadata/types/OnDeleteType\"\nimport { OnUpdateType } from \"../metadata/types/OnUpdateType\"\n\nexport type ReturningType = \"insert\" | \"update\" | \"delete\"\n\n/**\n * Driver organizes TypeORM communication with specific database management system.\n */\nexport interface Driver {\n    /**\n     * Connection options.\n     */\n    options: BaseDataSourceOptions\n\n    /**\n     * Database version/release. Often requires a SQL query to the DB, so it is not always set\n     */\n    version?: string\n\n    /**\n     * Database name used to perform all write queries.\n     *\n     * todo: probably move into query runner.\n     */\n    database?: string\n\n    /**\n     * Schema name used to perform all write queries.\n     */\n    schema?: string\n\n    /**\n     * Indicates if replication is enabled.\n     */\n    isReplicated: boolean\n\n    /**\n     * Indicates if tree tables are supported by this driver.\n     */\n    treeSupport: boolean\n\n    /**\n     * Represent transaction support by this driver\n     */\n    transactionSupport: \"simple\" | \"nested\" | \"none\"\n\n    /**\n     * Gets list of supported column data types by a driver.\n     */\n    supportedDataTypes: ColumnType[]\n\n    /**\n     * Returns type of upsert supported by driver if any\n     */\n    supportedUpsertTypes: UpsertType[]\n\n    /**\n     * Returns list of supported onDelete types by driver\n     */\n    supportedOnDeleteTypes?: OnDeleteType[]\n\n    /**\n     * Returns list of supported onUpdate types by driver\n     */\n    supportedOnUpdateTypes?: OnUpdateType[]\n\n    /**\n     * Default values of length, precision and scale depends on column data type.\n     * Used in the cases when length/precision/scale is not specified by user.\n     */\n    dataTypeDefaults: DataTypeDefaults\n\n    /**\n     * Gets list of spatial column data types.\n     */\n    spatialTypes: ColumnType[]\n\n    /**\n     * Gets list of column data types that support length by a driver.\n     */\n    withLengthColumnTypes: ColumnType[]\n\n    /**\n     * Gets list of column data types that support precision by a driver.\n     */\n    withPrecisionColumnTypes: ColumnType[]\n\n    /**\n     * Gets list of column data types that support scale by a driver.\n     */\n    withScaleColumnTypes: ColumnType[]\n\n    /**\n     * Orm has special columns and we need to know what database column types should be for those types.\n     * Column types are driver dependant.\n     */\n    mappedDataTypes: MappedColumnTypes\n\n    /**\n     * The prefix used for the parameters\n     */\n    parametersPrefix?: string\n\n    /**\n     * Max length allowed by the DBMS for aliases (execution of queries).\n     */\n    maxAliasLength?: number\n\n    cteCapabilities: CteCapabilities\n\n    /**\n     * Dummy table name\n     */\n    dummyTableName?: string\n\n    /**\n     * Performs connection to the database.\n     * Depend on driver type it may create a connection pool.\n     */\n    connect(): Promise<void>\n\n    /**\n     * Makes any action after connection (e.g. create extensions in Postgres driver).\n     */\n    afterConnect(): Promise<void>\n\n    /**\n     * Closes connection with database and releases all resources.\n     */\n    disconnect(): Promise<void>\n\n    /**\n     * Synchronizes database schema (creates tables, indices, etc).\n     */\n    createSchemaBuilder(): SchemaBuilder\n\n    /**\n     * Creates a query runner used for common queries.\n     */\n    createQueryRunner(mode: ReplicationMode): QueryRunner\n\n    /**\n     * Replaces parameters in the given sql with special escaping character\n     * and an array of parameter names to be passed to a query.\n     */\n    escapeQueryWithParameters(\n        sql: string,\n        parameters: ObjectLiteral,\n        nativeParameters: ObjectLiteral,\n    ): [string, any[]]\n\n    /**\n     * Escapes a table name, column name or an alias.\n     *\n     * todo: probably escape should be able to handle dots in the names and automatically escape them\n     */\n    escape(name: string): string\n\n    /**\n     * Build full table name with database name, schema name and table name.\n     * E.g. myDB.mySchema.myTable\n     */\n    buildTableName(\n        tableName: string,\n        schema?: string,\n        database?: string,\n    ): string\n\n    /**\n     * Parse a target table name or other types and return a normalized table definition.\n     */\n    parseTableName(\n        target: EntityMetadata | Table | View | TableForeignKey | string,\n    ): { tableName: string; schema?: string; database?: string }\n\n    /**\n     * Prepares given value to a value to be persisted, based on its column type and metadata.\n     */\n    preparePersistentValue(value: any, column: ColumnMetadata): any\n\n    /**\n     * Prepares given value to a value to be persisted, based on its column type.\n     */\n    prepareHydratedValue(value: any, column: ColumnMetadata): any\n\n    /**\n     * Transforms type of the given column to a database column type.\n     */\n    normalizeType(column: {\n        type?: ColumnType | string\n        length?: number | string\n        precision?: number | null\n        scale?: number\n        isArray?: boolean\n    }): string\n\n    /**\n     * Normalizes \"default\" value of the column.\n     */\n    normalizeDefault(columnMetadata: ColumnMetadata): string | undefined\n\n    /**\n     * Normalizes \"isUnique\" value of the column.\n     */\n    normalizeIsUnique(column: ColumnMetadata): boolean\n\n    /**\n     * Calculates column length taking into account the default length values.\n     */\n    getColumnLength(column: ColumnMetadata): string\n\n    /**\n     * Normalizes \"default\" value of the column.\n     */\n    createFullType(column: TableColumn): string\n\n    /**\n     * Obtains a new database connection to a master server.\n     * Used for replication.\n     * If replication is not setup then returns default connection's database connection.\n     */\n    obtainMasterConnection(): Promise<any>\n\n    /**\n     * Obtains a new database connection to a slave server.\n     * Used for replication.\n     * If replication is not setup then returns master (default) connection's database connection.\n     */\n    obtainSlaveConnection(): Promise<any>\n\n    /**\n     * Creates generated map of values generated or returned by database after INSERT query.\n     */\n    createGeneratedMap(\n        metadata: EntityMetadata,\n        insertResult: any,\n        entityIndex?: number,\n        entityNum?: number,\n    ): ObjectLiteral | undefined\n\n    /**\n     * Differentiate columns of this table and columns from the given column metadatas columns\n     * and returns only changed.\n     */\n    findChangedColumns(\n        tableColumns: TableColumn[],\n        columnMetadatas: ColumnMetadata[],\n    ): ColumnMetadata[]\n\n    /**\n     * Returns true if driver supports RETURNING / OUTPUT statement.\n     */\n    isReturningSqlSupported(returningType: ReturningType): boolean\n\n    /**\n     * Returns true if driver supports uuid values generation on its own.\n     */\n    isUUIDGenerationSupported(): boolean\n\n    /**\n     * Returns true if driver supports fulltext indices.\n     */\n    isFullTextColumnTypeSupported(): boolean\n\n    /**\n     * Creates an escaped parameter.\n     */\n    createParameter(parameterName: string, index: number): string\n}\n"],"sourceRoot":".."}

package/driver/DriverFactory.d.ts

@@ -0,0 +1,11 @@
+import { Driver } from "./Driver";
+import { DataSource } from "../data-source/DataSource";
+/**
+ * Helps to create drivers.
+ */
+export declare class DriverFactory {
+    /**
+     * Creates a new driver depend on a given connection's driver type.
+     */
+    create(connection: DataSource): Driver;
+}

package/driver/DriverFactory.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DriverFactory = void 0;
+const MissingDriverError_1 = require("../error/MissingDriverError");
+const CockroachDriver_1 = require("./cockroachdb/CockroachDriver");
+const MongoDriver_1 = require("./mongodb/MongoDriver");
+const SqlServerDriver_1 = require("./sqlserver/SqlServerDriver");
+const OracleDriver_1 = require("./oracle/OracleDriver");
+const SqliteDriver_1 = require("./sqlite/SqliteDriver");
+const CordovaDriver_1 = require("./cordova/CordovaDriver");
+const ReactNativeDriver_1 = require("./react-native/ReactNativeDriver");
+const NativescriptDriver_1 = require("./nativescript/NativescriptDriver");
+const SqljsDriver_1 = require("./sqljs/SqljsDriver");
+const MysqlDriver_1 = require("./mysql/MysqlDriver");
+const PostgresDriver_1 = require("./postgres/PostgresDriver");
+const ExpoDriverFactory_1 = require("./expo/ExpoDriverFactory");
+const AuroraMysqlDriver_1 = require("./aurora-mysql/AuroraMysqlDriver");
+const AuroraPostgresDriver_1 = require("./aurora-postgres/AuroraPostgresDriver");
+const SapDriver_1 = require("./sap/SapDriver");
+const BetterSqlite3Driver_1 = require("./better-sqlite3/BetterSqlite3Driver");
+const CapacitorDriver_1 = require("./capacitor/CapacitorDriver");
+const SpannerDriver_1 = require("./spanner/SpannerDriver");
+/**
+ * Helps to create drivers.
+ */
+class DriverFactory {
+    /**
+     * Creates a new driver depend on a given connection's driver type.
+     */
+    create(connection) {
+        const { type } = connection.options;
+        switch (type) {
+            case "mysql":
+                return new MysqlDriver_1.MysqlDriver(connection);
+            case "postgres":
+                return new PostgresDriver_1.PostgresDriver(connection);
+            case "cockroachdb":
+                return new CockroachDriver_1.CockroachDriver(connection);
+            case "sap":
+                return new SapDriver_1.SapDriver(connection);
+            case "mariadb":
+                return new MysqlDriver_1.MysqlDriver(connection);
+            case "sqlite":
+                return new SqliteDriver_1.SqliteDriver(connection);
+            case "better-sqlite3":
+                return new BetterSqlite3Driver_1.BetterSqlite3Driver(connection);
+            case "cordova":
+                return new CordovaDriver_1.CordovaDriver(connection);
+            case "nativescript":
+                return new NativescriptDriver_1.NativescriptDriver(connection);
+            case "react-native":
+                return new ReactNativeDriver_1.ReactNativeDriver(connection);
+            case "sqljs":
+                return new SqljsDriver_1.SqljsDriver(connection);
+            case "oracle":
+                return new OracleDriver_1.OracleDriver(connection);
+            case "mssql":
+                return new SqlServerDriver_1.SqlServerDriver(connection);
+            case "mongodb":
+                return new MongoDriver_1.MongoDriver(connection);
+            case "expo":
+                return new ExpoDriverFactory_1.ExpoDriverFactory(connection).create();
+            case "aurora-mysql":
+                return new AuroraMysqlDriver_1.AuroraMysqlDriver(connection);
+            case "aurora-postgres":
+                return new AuroraPostgresDriver_1.AuroraPostgresDriver(connection);
+            case "capacitor":
+                return new CapacitorDriver_1.CapacitorDriver(connection);
+            case "spanner":
+                return new SpannerDriver_1.SpannerDriver(connection);
+            default:
+                throw new MissingDriverError_1.MissingDriverError(type, [
+                    "aurora-mysql",
+                    "aurora-postgres",
+                    "better-sqlite3",
+                    "capacitor",
+                    "cockroachdb",
+                    "cordova",
+                    "expo",
+                    "mariadb",
+                    "mongodb",
+                    "mssql",
+                    "mysql",
+                    "nativescript",
+                    "oracle",
+                    "postgres",
+                    "react-native",
+                    "sap",
+                    "sqlite",
+                    "sqljs",
+                    "spanner",
+                ]);
+        }
+    }
+}
+exports.DriverFactory = DriverFactory;
+
+//# sourceMappingURL=DriverFactory.js.map

package/driver/DriverFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/driver/DriverFactory.ts"],"names":[],"mappings":";;;AAAA,oEAAgE;AAChE,mEAA+D;AAC/D,uDAAmD;AACnD,iEAA6D;AAC7D,wDAAoD;AACpD,wDAAoD;AACpD,2DAAuD;AACvD,wEAAoE;AACpE,0EAAsE;AACtE,qDAAiD;AACjD,qDAAiD;AACjD,8DAA0D;AAC1D,gEAA4D;AAC5D,wEAAoE;AACpE,iFAA6E;AAG7E,+CAA2C;AAC3C,8EAA0E;AAC1E,iEAA6D;AAC7D,2DAAuD;AAEvD;;GAEG;AACH,MAAa,aAAa;IACtB;;OAEG;IACH,MAAM,CAAC,UAAsB;QACzB,MAAM,EAAE,IAAI,EAAE,GAAG,UAAU,CAAC,OAAO,CAAA;QACnC,QAAQ,IAAI,EAAE,CAAC;YACX,KAAK,OAAO;gBACR,OAAO,IAAI,yBAAW,CAAC,UAAU,CAAC,CAAA;YACtC,KAAK,UAAU;gBACX,OAAO,IAAI,+BAAc,CAAC,UAAU,CAAC,CAAA;YACzC,KAAK,aAAa;gBACd,OAAO,IAAI,iCAAe,CAAC,UAAU,CAAC,CAAA;YAC1C,KAAK,KAAK;gBACN,OAAO,IAAI,qBAAS,CAAC,UAAU,CAAC,CAAA;YACpC,KAAK,SAAS;gBACV,OAAO,IAAI,yBAAW,CAAC,UAAU,CAAC,CAAA;YACtC,KAAK,QAAQ;gBACT,OAAO,IAAI,2BAAY,CAAC,UAAU,CAAC,CAAA;YACvC,KAAK,gBAAgB;gBACjB,OAAO,IAAI,yCAAmB,CAAC,UAAU,CAAC,CAAA;YAC9C,KAAK,SAAS;gBACV,OAAO,IAAI,6BAAa,CAAC,UAAU,CAAC,CAAA;YACxC,KAAK,cAAc;gBACf,OAAO,IAAI,uCAAkB,CAAC,UAAU,CAAC,CAAA;YAC7C,KAAK,cAAc;gBACf,OAAO,IAAI,qCAAiB,CAAC,UAAU,CAAC,CAAA;YAC5C,KAAK,OAAO;gBACR,OAAO,IAAI,yBAAW,CAAC,UAAU,CAAC,CAAA;YACtC,KAAK,QAAQ;gBACT,OAAO,IAAI,2BAAY,CAAC,UAAU,CAAC,CAAA;YACvC,KAAK,OAAO;gBACR,OAAO,IAAI,iCAAe,CAAC,UAAU,CAAC,CAAA;YAC1C,KAAK,SAAS;gBACV,OAAO,IAAI,yBAAW,CAAC,UAAU,CAAC,CAAA;YACtC,KAAK,MAAM;gBACP,OAAO,IAAI,qCAAiB,CAAC,UAAU,CAAC,CAAC,MAAM,EAAE,CAAA;YACrD,KAAK,cAAc;gBACf,OAAO,IAAI,qCAAiB,CAAC,UAAU,CAAC,CAAA;YAC5C,KAAK,iBAAiB;gBAClB,OAAO,IAAI,2CAAoB,CAAC,UAAU,CAAC,CAAA;YAC/C,KAAK,WAAW;gBACZ,OAAO,IAAI,iCAAe,CAAC,UAAU,CAAC,CAAA;YAC1C,KAAK,SAAS;gBACV,OAAO,IAAI,6BAAa,CAAC,UAAU,CAAC,CAAA;YACxC;gBACI,MAAM,IAAI,uCAAkB,CAAC,IAAI,EAAE;oBAC/B,cAAc;oBACd,iBAAiB;oBACjB,gBAAgB;oBAChB,WAAW;oBACX,aAAa;oBACb,SAAS;oBACT,MAAM;oBACN,SAAS;oBACT,SAAS;oBACT,OAAO;oBACP,OAAO;oBACP,cAAc;oBACd,QAAQ;oBACR,UAAU;oBACV,cAAc;oBACd,KAAK;oBACL,QAAQ;oBACR,OAAO;oBACP,SAAS;iBACZ,CAAC,CAAA;QACV,CAAC;IACL,CAAC;CACJ;AArED,sCAqEC","file":"DriverFactory.js","sourcesContent":["import { MissingDriverError } from \"../error/MissingDriverError\"\nimport { CockroachDriver } from \"./cockroachdb/CockroachDriver\"\nimport { MongoDriver } from \"./mongodb/MongoDriver\"\nimport { SqlServerDriver } from \"./sqlserver/SqlServerDriver\"\nimport { OracleDriver } from \"./oracle/OracleDriver\"\nimport { SqliteDriver } from \"./sqlite/SqliteDriver\"\nimport { CordovaDriver } from \"./cordova/CordovaDriver\"\nimport { ReactNativeDriver } from \"./react-native/ReactNativeDriver\"\nimport { NativescriptDriver } from \"./nativescript/NativescriptDriver\"\nimport { SqljsDriver } from \"./sqljs/SqljsDriver\"\nimport { MysqlDriver } from \"./mysql/MysqlDriver\"\nimport { PostgresDriver } from \"./postgres/PostgresDriver\"\nimport { ExpoDriverFactory } from \"./expo/ExpoDriverFactory\"\nimport { AuroraMysqlDriver } from \"./aurora-mysql/AuroraMysqlDriver\"\nimport { AuroraPostgresDriver } from \"./aurora-postgres/AuroraPostgresDriver\"\nimport { Driver } from \"./Driver\"\nimport { DataSource } from \"../data-source/DataSource\"\nimport { SapDriver } from \"./sap/SapDriver\"\nimport { BetterSqlite3Driver } from \"./better-sqlite3/BetterSqlite3Driver\"\nimport { CapacitorDriver } from \"./capacitor/CapacitorDriver\"\nimport { SpannerDriver } from \"./spanner/SpannerDriver\"\n\n/**\n * Helps to create drivers.\n */\nexport class DriverFactory {\n    /**\n     * Creates a new driver depend on a given connection's driver type.\n     */\n    create(connection: DataSource): Driver {\n        const { type } = connection.options\n        switch (type) {\n            case \"mysql\":\n                return new MysqlDriver(connection)\n            case \"postgres\":\n                return new PostgresDriver(connection)\n            case \"cockroachdb\":\n                return new CockroachDriver(connection)\n            case \"sap\":\n                return new SapDriver(connection)\n            case \"mariadb\":\n                return new MysqlDriver(connection)\n            case \"sqlite\":\n                return new SqliteDriver(connection)\n            case \"better-sqlite3\":\n                return new BetterSqlite3Driver(connection)\n            case \"cordova\":\n                return new CordovaDriver(connection)\n            case \"nativescript\":\n                return new NativescriptDriver(connection)\n            case \"react-native\":\n                return new ReactNativeDriver(connection)\n            case \"sqljs\":\n                return new SqljsDriver(connection)\n            case \"oracle\":\n                return new OracleDriver(connection)\n            case \"mssql\":\n                return new SqlServerDriver(connection)\n            case \"mongodb\":\n                return new MongoDriver(connection)\n            case \"expo\":\n                return new ExpoDriverFactory(connection).create()\n            case \"aurora-mysql\":\n                return new AuroraMysqlDriver(connection)\n            case \"aurora-postgres\":\n                return new AuroraPostgresDriver(connection)\n            case \"capacitor\":\n                return new CapacitorDriver(connection)\n            case \"spanner\":\n                return new SpannerDriver(connection)\n            default:\n                throw new MissingDriverError(type, [\n                    \"aurora-mysql\",\n                    \"aurora-postgres\",\n                    \"better-sqlite3\",\n                    \"capacitor\",\n                    \"cockroachdb\",\n                    \"cordova\",\n                    \"expo\",\n                    \"mariadb\",\n                    \"mongodb\",\n                    \"mssql\",\n                    \"mysql\",\n                    \"nativescript\",\n                    \"oracle\",\n                    \"postgres\",\n                    \"react-native\",\n                    \"sap\",\n                    \"sqlite\",\n                    \"sqljs\",\n                    \"spanner\",\n                ])\n        }\n    }\n}\n"],"sourceRoot":".."}

package/driver/DriverUtils.d.ts

@@ -0,0 +1,61 @@
+import { Driver } from "./Driver";
+/**
+ * Common driver utility functions.
+ */
+export declare class DriverUtils {
+    /**
+     * Returns true if given driver is SQLite-based driver.
+     */
+    static isSQLiteFamily(driver: Driver): boolean;
+    /**
+     * Returns true if given driver is MySQL-based driver.
+     */
+    static isMySQLFamily(driver: Driver): boolean;
+    static isReleaseVersionOrGreater(driver: Driver, version: string): boolean;
+    static isPostgresFamily(driver: Driver): boolean;
+    /**
+     * Normalizes and builds a new driver options.
+     * Extracts settings from connection url and sets to a new options object.
+     */
+    static buildDriverOptions(options: any, buildOptions?: {
+        useSid: boolean;
+    }): any;
+    /**
+     * buildDriverOptions for MongodDB only to support replica set
+     */
+    static buildMongoDBDriverOptions(options: any, buildOptions?: {
+        useSid: boolean;
+    }): any;
+    /**
+     * Joins and shortens alias if needed.
+     *
+     * If the alias length is greater than the limit allowed by the current
+     * driver, replaces it with a shortend string, if the shortend string
+     * is still too long, it will then hash the alias.
+     *
+     * @param driver Current `Driver`.
+     * @param buildOptions Optional settings.
+     * @param alias Alias parts.
+     *
+     * @return An alias that is no longer than the divers max alias length.
+     */
+    static buildAlias({ maxAliasLength }: Driver, buildOptions: {
+        shorten?: boolean;
+        joiner?: string;
+    } | undefined, ...alias: string[]): string;
+    /**
+     * @deprecated use `buildAlias` instead.
+     */
+    static buildColumnAlias({ maxAliasLength }: Driver, buildOptions: {
+        shorten?: boolean;
+        joiner?: string;
+    } | string, ...alias: string[]): string;
+    /**
+     * Extracts connection data from the connection url.
+     */
+    private static parseConnectionUrl;
+    /**
+     * Extracts connection data from the connection url for MongoDB to support replica set.
+     */
+    private static parseMongoDBConnectionUrl;
+}

package/driver/DriverUtils.js

@@ -0,0 +1,228 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DriverUtils = void 0;
+const StringUtils_1 = require("../util/StringUtils");
+const VersionUtils_1 = require("../util/VersionUtils");
+/**
+ * Common driver utility functions.
+ */
+class DriverUtils {
+    // -------------------------------------------------------------------------
+    // Public Static Methods
+    // -------------------------------------------------------------------------
+    /**
+     * Returns true if given driver is SQLite-based driver.
+     */
+    static isSQLiteFamily(driver) {
+        return [
+            "sqlite",
+            "cordova",
+            "react-native",
+            "nativescript",
+            "sqljs",
+            "expo",
+            "better-sqlite3",
+            "capacitor",
+        ].includes(driver.options.type);
+    }
+    /**
+     * Returns true if given driver is MySQL-based driver.
+     */
+    static isMySQLFamily(driver) {
+        return ["mysql", "mariadb"].includes(driver.options.type);
+    }
+    static isReleaseVersionOrGreater(driver, version) {
+        return VersionUtils_1.VersionUtils.isGreaterOrEqual(driver.version, version);
+    }
+    static isPostgresFamily(driver) {
+        return ["postgres", "aurora-postgres", "cockroachdb"].includes(driver.options.type);
+    }
+    /**
+     * Normalizes and builds a new driver options.
+     * Extracts settings from connection url and sets to a new options object.
+     */
+    static buildDriverOptions(options, buildOptions) {
+        if (options.url) {
+            const urlDriverOptions = this.parseConnectionUrl(options.url);
+            if (buildOptions &&
+                buildOptions.useSid &&
+                urlDriverOptions.database) {
+                urlDriverOptions.sid = urlDriverOptions.database;
+            }
+            for (const key of Object.keys(urlDriverOptions)) {
+                if (typeof urlDriverOptions[key] === "undefined") {
+                    delete urlDriverOptions[key];
+                }
+            }
+            return Object.assign({}, options, urlDriverOptions);
+        }
+        return Object.assign({}, options);
+    }
+    /**
+     * buildDriverOptions for MongodDB only to support replica set
+     */
+    static buildMongoDBDriverOptions(options, buildOptions) {
+        if (options.url) {
+            const urlDriverOptions = this.parseMongoDBConnectionUrl(options.url);
+            if (buildOptions &&
+                buildOptions.useSid &&
+                urlDriverOptions.database) {
+                urlDriverOptions.sid = urlDriverOptions.database;
+            }
+            for (const key of Object.keys(urlDriverOptions)) {
+                if (typeof urlDriverOptions[key] === "undefined") {
+                    delete urlDriverOptions[key];
+                }
+            }
+            return Object.assign({}, options, urlDriverOptions);
+        }
+        return Object.assign({}, options);
+    }
+    /**
+     * Joins and shortens alias if needed.
+     *
+     * If the alias length is greater than the limit allowed by the current
+     * driver, replaces it with a shortend string, if the shortend string
+     * is still too long, it will then hash the alias.
+     *
+     * @param driver Current `Driver`.
+     * @param buildOptions Optional settings.
+     * @param alias Alias parts.
+     *
+     * @return An alias that is no longer than the divers max alias length.
+     */
+    static buildAlias({ maxAliasLength }, buildOptions, ...alias) {
+        const joiner = buildOptions && buildOptions.joiner ? buildOptions.joiner : "_";
+        const newAlias = alias.length === 1 ? alias[0] : alias.join(joiner);
+        if (maxAliasLength &&
+            maxAliasLength > 0 &&
+            newAlias.length > maxAliasLength) {
+            if (buildOptions && buildOptions.shorten === true) {
+                const shortenedAlias = (0, StringUtils_1.shorten)(newAlias);
+                if (shortenedAlias.length < maxAliasLength) {
+                    return shortenedAlias;
+                }
+            }
+            return (0, StringUtils_1.hash)(newAlias, { length: maxAliasLength });
+        }
+        return newAlias;
+    }
+    /**
+     * @deprecated use `buildAlias` instead.
+     */
+    static buildColumnAlias({ maxAliasLength }, buildOptions, ...alias) {
+        if (typeof buildOptions === "string") {
+            alias.unshift(buildOptions);
+            buildOptions = { shorten: false, joiner: "_" };
+        }
+        else {
+            buildOptions = Object.assign({ shorten: false, joiner: "_" }, buildOptions);
+        }
+        return this.buildAlias({ maxAliasLength }, buildOptions, ...alias);
+    }
+    // -------------------------------------------------------------------------
+    // Private Static Methods
+    // -------------------------------------------------------------------------
+    /**
+     * Extracts connection data from the connection url.
+     */
+    static parseConnectionUrl(url) {
+        const type = url.split(":")[0];
+        const firstSlashes = url.indexOf("//");
+        const preBase = url.substr(firstSlashes + 2);
+        const secondSlash = preBase.indexOf("/");
+        const base = secondSlash !== -1 ? preBase.substr(0, secondSlash) : preBase;
+        let afterBase = secondSlash !== -1 ? preBase.substr(secondSlash + 1) : undefined;
+        // remove mongodb query params
+        if (afterBase && afterBase.indexOf("?") !== -1) {
+            afterBase = afterBase.substr(0, afterBase.indexOf("?"));
+        }
+        const lastAtSign = base.lastIndexOf("@");
+        const usernameAndPassword = base.substr(0, lastAtSign);
+        const hostAndPort = base.substr(lastAtSign + 1);
+        let username = usernameAndPassword;
+        let password = "";
+        const firstColon = usernameAndPassword.indexOf(":");
+        if (firstColon !== -1) {
+            username = usernameAndPassword.substr(0, firstColon);
+            password = usernameAndPassword.substr(firstColon + 1);
+        }
+        const [host, port] = hostAndPort.split(":");
+        return {
+            type: type,
+            host: host,
+            username: decodeURIComponent(username),
+            password: decodeURIComponent(password),
+            port: port ? parseInt(port) : undefined,
+            database: afterBase || undefined,
+        };
+    }
+    /**
+     * Extracts connection data from the connection url for MongoDB to support replica set.
+     */
+    static parseMongoDBConnectionUrl(url) {
+        const type = url.split(":")[0];
+        const firstSlashes = url.indexOf("//");
+        const preBase = url.substr(firstSlashes + 2);
+        const secondSlash = preBase.indexOf("/");
+        const base = secondSlash !== -1 ? preBase.substr(0, secondSlash) : preBase;
+        let afterBase = secondSlash !== -1 ? preBase.substr(secondSlash + 1) : undefined;
+        let afterQuestionMark = "";
+        let host = undefined;
+        let port = undefined;
+        let hostReplicaSet = undefined;
+        let replicaSet = undefined;
+        const optionsObject = {};
+        if (afterBase && afterBase.indexOf("?") !== -1) {
+            // split params
+            afterQuestionMark = afterBase.substr(afterBase.indexOf("?") + 1, afterBase.length);
+            const optionsList = afterQuestionMark.split("&");
+            let optionKey;
+            let optionValue;
+            // create optionsObject for merge with connectionUrl object before return
+            optionsList.forEach((optionItem) => {
+                optionKey = optionItem.split("=")[0];
+                optionValue = optionItem.split("=")[1];
+                optionsObject[optionKey] = optionValue;
+            });
+            // specific replicaSet value to set options about hostReplicaSet
+            replicaSet = optionsObject["replicaSet"];
+            afterBase = afterBase.substr(0, afterBase.indexOf("?"));
+        }
+        const lastAtSign = base.lastIndexOf("@");
+        const usernameAndPassword = base.substr(0, lastAtSign);
+        const hostAndPort = base.substr(lastAtSign + 1);
+        let username = usernameAndPassword;
+        let password = "";
+        const firstColon = usernameAndPassword.indexOf(":");
+        if (firstColon !== -1) {
+            username = usernameAndPassword.substr(0, firstColon);
+            password = usernameAndPassword.substr(firstColon + 1);
+        }
+        // If replicaSet have value set It as hostlist, If not set like standalone host
+        if (replicaSet) {
+            hostReplicaSet = hostAndPort;
+        }
+        else {
+            ;
+            [host, port] = hostAndPort.split(":");
+        }
+        const connectionUrl = {
+            type: type,
+            host: host,
+            hostReplicaSet: hostReplicaSet,
+            username: decodeURIComponent(username),
+            password: decodeURIComponent(password),
+            port: port ? parseInt(port) : undefined,
+            database: afterBase || undefined,
+        };
+        // Loop to set every options in connectionUrl to object
+        for (const [key, value] of Object.entries(optionsObject)) {
+            connectionUrl[key] = value;
+        }
+        return connectionUrl;
+    }
+}
+exports.DriverUtils = DriverUtils;
+
+//# sourceMappingURL=DriverUtils.js.map