typeorm 1.0.0-beta.1 → 1.0.0-beta.2

package/browser/driver/types/IsolationLevel.d.ts

@@ -1 +1,2 @@
-export type IsolationLevel = "READ UNCOMMITTED" | "READ COMMITTED" | "REPEATABLE READ" | "SERIALIZABLE";
+export declare const IsolationLevels: readonly ["READ COMMITTED", "READ UNCOMMITTED", "REPEATABLE READ", "SERIALIZABLE", "SNAPSHOT"];
+export type IsolationLevel = (typeof IsolationLevels)[number];

package/browser/driver/types/IsolationLevel.js

@@ -1,3 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.IsolationLevels = void 0;
+exports.IsolationLevels = [
+    "READ COMMITTED",
+    "READ UNCOMMITTED",
+    "REPEATABLE READ",
+    "SERIALIZABLE",
+    "SNAPSHOT",
+];
 //# sourceMappingURL=IsolationLevel.js.map

package/browser/driver/types/IsolationLevel.js.map

@@ -1 +1 @@
-{"version":3,"file":"IsolationLevel.js","sourceRoot":"../build/browser/src/","sources":["driver/types/IsolationLevel.ts"],"names":[],"mappings":"","sourcesContent":["export type IsolationLevel =\n    | \"READ UNCOMMITTED\"\n    | \"READ COMMITTED\"\n    | \"REPEATABLE READ\"\n    | \"SERIALIZABLE\"\n"]}
+{"version":3,"file":"IsolationLevel.js","sourceRoot":"../build/browser/src/","sources":["driver/types/IsolationLevel.ts"],"names":[],"mappings":";;;AAAa,QAAA,eAAe,GAAG;IAC3B,gBAAgB;IAChB,kBAAkB;IAClB,iBAAiB;IACjB,cAAc;IACd,UAAU;CACJ,CAAA","sourcesContent":["export const IsolationLevels = [\n    \"READ COMMITTED\",\n    \"READ UNCOMMITTED\",\n    \"REPEATABLE READ\",\n    \"SERIALIZABLE\",\n    \"SNAPSHOT\",\n] as const\n\nexport type IsolationLevel = (typeof IsolationLevels)[number]\n"]}

package/browser/driver/validate-isolation-level.d.ts

@@ -0,0 +1,9 @@
+import type { IsolationLevel } from "./types/IsolationLevel";
+/**
+ * Validates that the given isolation level is in the provided list of supported levels.
+ * Throws a TypeORMError if not supported.
+ *
+ * @param supported
+ * @param isolationLevel
+ */
+export declare const validateIsolationLevel: (supported: readonly IsolationLevel[], isolationLevel?: IsolationLevel) => void;

package/browser/driver/validate-isolation-level.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateIsolationLevel = void 0;
+const TypeORMError_1 = require("../error/TypeORMError");
+/**
+ * Validates that the given isolation level is in the provided list of supported levels.
+ * Throws a TypeORMError if not supported.
+ *
+ * @param supported
+ * @param isolationLevel
+ */
+const validateIsolationLevel = (supported, isolationLevel) => {
+    if (!isolationLevel)
+        return;
+    if (!supported || !Array.isArray(supported)) {
+        throw new TypeORMError_1.TypeORMError(`Driver must define supportedIsolationLevels to use isolationLevel option`);
+    }
+    if (!supported.includes(isolationLevel)) {
+        throw new TypeORMError_1.TypeORMError(`${isolationLevel} isolation level is not supported`);
+    }
+};
+exports.validateIsolationLevel = validateIsolationLevel;
+//# sourceMappingURL=validate-isolation-level.js.map

package/browser/driver/validate-isolation-level.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-isolation-level.js","sourceRoot":"../build/browser/src/","sources":["driver/validate-isolation-level.ts"],"names":[],"mappings":";;;AAAA,wDAAoD;AAGpD;;;;;;GAMG;AACI,MAAM,sBAAsB,GAAG,CAClC,SAAoC,EACpC,cAA+B,EAC3B,EAAE;IACN,IAAI,CAAC,cAAc;QAAE,OAAM;IAE3B,IAAI,CAAC,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,2BAAY,CAClB,0EAA0E,CAC7E,CAAA;IACL,CAAC;IAED,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,2BAAY,CAClB,GAAG,cAAc,mCAAmC,CACvD,CAAA;IACL,CAAC;AACL,CAAC,CAAA;AAjBY,QAAA,sBAAsB,0BAiBlC","sourcesContent":["import { TypeORMError } from \"../error/TypeORMError\"\nimport type { IsolationLevel } from \"./types/IsolationLevel\"\n\n/**\n * Validates that the given isolation level is in the provided list of supported levels.\n * Throws a TypeORMError if not supported.\n *\n * @param supported\n * @param isolationLevel\n */\nexport const validateIsolationLevel = (\n    supported: readonly IsolationLevel[],\n    isolationLevel?: IsolationLevel,\n): void => {\n    if (!isolationLevel) return\n\n    if (!supported || !Array.isArray(supported)) {\n        throw new TypeORMError(\n            `Driver must define supportedIsolationLevels to use isolationLevel option`,\n        )\n    }\n\n    if (!supported.includes(isolationLevel)) {\n        throw new TypeORMError(\n            `${isolationLevel} isolation level is not supported`,\n        )\n    }\n}\n"]}

package/browser/entity-manager/EntityManager.d.ts

@@ -34,6 +34,7 @@ export declare class EntityManager {
     readonly dataSource: DataSource;
     /**
      * DataSource used by this entity manager.
+     *
      * @deprecated since 1.0.0. Use {@link dataSource} instance instead.
      */
     get connection(): DataSource;
@@ -68,6 +69,7 @@ export declare class EntityManager {
     transaction<T>(isolationLevel: IsolationLevel, runInTransaction: (entityManager: EntityManager) => Promise<T>): Promise<T>;
     /**
      * Executes raw SQL query and returns raw database results.
+     *
      * @param query
      * @param parameters
      * @see [Official docs](https://typeorm.io/docs/Working%20with%20Entity%20Manager/entity-manager-api/) for examples.
@@ -78,7 +80,10 @@ export declare class EntityManager {
      * Template expressions are automatically transformed into database parameters.
      * Raw query execution is supported only by relational databases (MongoDB is not supported).
      * Note: Don't call this as a regular function, it is meant to be used with backticks to tag a template literal.
-     * Example: entityManager.sql`SELECT * FROM table_name WHERE id = ${id}`
+     *
+     * @example
+     * entityManager.sql`SELECT * FROM table_name WHERE id = ${id}`
+     *
      * @param strings
      * @param values
      */
@@ -119,6 +124,7 @@ export declare class EntityManager {
     create<Entity, EntityLike extends DeepPartial<Entity>>(entityClass: EntityTarget<Entity>, plainObjects?: EntityLike[]): Entity[];
     /**
      * Merges two entities into one new entity.
+     *
      * @param entityClass
      * @param mergeIntoEntity
      * @param entityLikes
@@ -129,6 +135,7 @@ export declare class EntityManager {
      * it loads it (and everything related to it), replaces all values with the new ones from the given object
      * and returns this new entity. This new entity is actually a loaded from the db entity with all properties
      * replaced from the new object.
+     *
      * @param entityClass
      * @param entityLike
      */
@@ -221,6 +228,7 @@ export declare class EntityManager {
      * Executes fast and efficient INSERT query.
      * Does not check if entity exist in the database, so query will fail if duplicate entity is being inserted.
      * You can execute bulk inserts using this method.
+     *
      * @param target
      * @param entity
      */
@@ -232,6 +240,7 @@ export declare class EntityManager {
      * Executes fast and efficient UPDATE query.
      * Does not check if entity exist in the database.
      * Condition(s) cannot be empty.
+     *
      * @param target
      * @param criteria
      * @param partialEntity
@@ -244,6 +253,7 @@ export declare class EntityManager {
      * Executes fast and efficient UPDATE query without WHERE clause.
      *
      * WARNING! This method updates ALL rows in the target table.
+     *
      * @param target
      * @param partialEntity
      * @param options
@@ -255,6 +265,7 @@ export declare class EntityManager {
      * Executes fast and efficient DELETE query.
      * Does not check if entity exist in the database.
      * Condition(s) cannot be empty.
+     *
      * @param targetOrEntity
      * @param criteria
      */
@@ -265,6 +276,7 @@ export declare class EntityManager {
      * Executes fast and efficient DELETE query without WHERE clause.
      *
      * WARNING! This method deletes ALL rows in the target table.
+     *
      * @param targetOrEntity
      */
     deleteAll<Entity extends ObjectLiteral>(targetOrEntity: EntityTarget<Entity>): Promise<DeleteResult>;
@@ -274,6 +286,7 @@ export declare class EntityManager {
      * Executes fast and efficient UPDATE query.
      * Does not check if entity exist in the database.
      * Condition(s) cannot be empty.
+     *
      * @param targetOrEntity
      * @param criteria
      */
@@ -284,18 +297,21 @@ export declare class EntityManager {
      * Executes fast and efficient UPDATE query.
      * Does not check if entity exist in the database.
      * Condition(s) cannot be empty.
+     *
      * @param targetOrEntity
      * @param criteria
      */
     restore<Entity extends ObjectLiteral>(targetOrEntity: EntityTarget<Entity>, criteria: string | string[] | number | number[] | Date | Date[] | ObjectId | ObjectId[] | any): Promise<UpdateResult>;
     /**
      * Checks whether any entity exists with the given options.
+     *
      * @param entityClass
      * @param options
      */
     exists<Entity extends ObjectLiteral>(entityClass: EntityTarget<Entity>, options?: FindManyOptions<Entity>): Promise<boolean>;
     /**
      * Checks whether any entity exists with the given conditions.
+     *
      * @param entityClass
      * @param where
      */
@@ -303,6 +319,7 @@ export declare class EntityManager {
     /**
      * Counts entities that match given options.
      * Useful for pagination.
+     *
      * @param entityClass
      * @param options
      */
@@ -310,12 +327,14 @@ export declare class EntityManager {
     /**
      * Counts entities that match given conditions.
      * Useful for pagination.
+     *
      * @param entityClass
      * @param where
      */
     countBy<Entity extends ObjectLiteral>(entityClass: EntityTarget<Entity>, where: FindOptionsWhere<Entity> | FindOptionsWhere<Entity>[]): Promise<number>;
     /**
      * Return the SUM of a column
+     *
      * @param entityClass
      * @param columnName
      * @param where
@@ -323,6 +342,7 @@ export declare class EntityManager {
     sum<Entity extends ObjectLiteral>(entityClass: EntityTarget<Entity>, columnName: PickKeysByType<Entity, number>, where?: FindOptionsWhere<Entity> | FindOptionsWhere<Entity>[]): Promise<number | null>;
     /**
      * Return the AVG of a column
+     *
      * @param entityClass
      * @param columnName
      * @param where
@@ -330,6 +350,7 @@ export declare class EntityManager {
     average<Entity extends ObjectLiteral>(entityClass: EntityTarget<Entity>, columnName: PickKeysByType<Entity, number>, where?: FindOptionsWhere<Entity> | FindOptionsWhere<Entity>[]): Promise<number | null>;
     /**
      * Return the MIN of a column
+     *
      * @param entityClass
      * @param columnName
      * @param where
@@ -337,6 +358,7 @@ export declare class EntityManager {
     minimum<Entity extends ObjectLiteral>(entityClass: EntityTarget<Entity>, columnName: PickKeysByType<Entity, number>, where?: FindOptionsWhere<Entity> | FindOptionsWhere<Entity>[]): Promise<number | null>;
     /**
      * Return the MAX of a column
+     *
      * @param entityClass
      * @param columnName
      * @param where
@@ -345,12 +367,14 @@ export declare class EntityManager {
     private callAggregateFun;
     /**
      * Finds entities that match given find options.
+     *
      * @param entityClass
      * @param options
      */
     find<Entity extends ObjectLiteral>(entityClass: EntityTarget<Entity>, options?: FindManyOptions<Entity>): Promise<Entity[]>;
     /**
      * Finds entities that match given find options.
+     *
      * @param entityClass
      * @param where
      */
@@ -359,6 +383,7 @@ export declare class EntityManager {
      * Finds entities that match given find options.
      * Also counts all entities that match given conditions,
      * but ignores pagination settings (from and take options).
+     *
      * @param entityClass
      * @param options
      */
@@ -367,6 +392,7 @@ export declare class EntityManager {
      * Finds entities that match given WHERE conditions.
      * Also counts all entities that match given conditions,
      * but ignores pagination settings (from and take options).
+     *
      * @param entityClass
      * @param where
      */
@@ -374,6 +400,7 @@ export declare class EntityManager {
     /**
      * Finds first entity by a given find options.
      * If entity was not found in the database - returns null.
+     *
      * @param entityClass
      * @param options
      */
@@ -381,6 +408,7 @@ export declare class EntityManager {
     /**
      * Finds first entity that matches given where condition.
      * If entity was not found in the database - returns null.
+     *
      * @param entityClass
      * @param where
      */
@@ -388,6 +416,7 @@ export declare class EntityManager {
     /**
      * Finds first entity by a given find options.
      * If entity was not found in the database - rejects with error.
+     *
      * @param entityClass
      * @param options
      */
@@ -395,6 +424,7 @@ export declare class EntityManager {
     /**
      * Finds first entity that matches given where condition.
      * If entity was not found in the database - rejects with error.
+     *
      * @param entityClass
      * @param where
      */
@@ -403,6 +433,7 @@ export declare class EntityManager {
      * Clears all the data from the given table (truncates/drops it).
      *
      * Note: this method uses TRUNCATE and may not work as you expect in transactions on some platforms.
+     *
      * @param entityClass
      * @param options
      * @param options.cascade
@@ -413,6 +444,7 @@ export declare class EntityManager {
     }): Promise<void>;
     /**
      * Increments some column by provided value of the entities matched given conditions.
+     *
      * @param entityClass
      * @param conditions
      * @param propertyPath
@@ -421,6 +453,7 @@ export declare class EntityManager {
     increment<Entity extends ObjectLiteral>(entityClass: EntityTarget<Entity>, conditions: FindOptionsWhere<Entity>, propertyPath: string, value: number | string): Promise<UpdateResult>;
     /**
      * Decrements some column by provided value of the entities matched given conditions.
+     *
      * @param entityClass
      * @param conditions
      * @param propertyPath
@@ -432,6 +465,7 @@ export declare class EntityManager {
      * If single database connection mode is used, then repository is obtained from the
      * repository aggregator, where each repository is individually created for this entity manager.
      * When single database connection is not used, repository is being obtained from the connection.
+     *
      * @param target
      */
     getRepository<Entity extends ObjectLiteral>(target: EntityTarget<Entity>): Repository<Entity>;
@@ -440,11 +474,13 @@ export declare class EntityManager {
      * If single database connection mode is used, then repository is obtained from the
      * repository aggregator, where each repository is individually created for this entity manager.
      * When single database connection is not used, repository is being obtained from the connection.
+     *
      * @param target
      */
     getTreeRepository<Entity extends ObjectLiteral>(target: EntityTarget<Entity>): TreeRepository<Entity>;
     /**
      * Gets mongodb repository for the given entity class.
+     *
      * @param target
      */
     getMongoRepository<Entity extends ObjectLiteral>(target: EntityTarget<Entity>): MongoRepository<Entity>;
@@ -452,6 +488,7 @@ export declare class EntityManager {
      * Creates a new repository instance out of a given Repository and
      * sets current EntityManager instance to it. Used to work with custom repositories
      * in transactions.
+     *
      * @param repository
      */
     withRepository<Entity extends ObjectLiteral, R extends Repository<any>>(repository: R & Repository<Entity>): R;