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

package/driver/sqlite-abstract/AbstractSqliteDriver.d.ts

@@ -15,6 +15,7 @@ import type { CteCapabilities } from "../types/CteCapabilities";
 import type { DataTypeDefaults } from "../types/DataTypeDefaults";
 import type { MappedColumnTypes } from "../types/MappedColumnTypes";
 import type { ReplicationMode } from "../types/ReplicationMode";
+import type { IsolationLevel } from "../types/IsolationLevel";
 import type { UpsertType } from "../types/UpsertType";
 type DatabasesMap = Record<string, {
     attachFilepathAbsolute: string;
@@ -25,12 +26,23 @@ type DatabasesMap = Record<string, {
  * Organizes communication with sqlite DBMS.
  */
 export declare abstract class AbstractSqliteDriver implements Driver {
+    /**
+     * Transaction isolation levels supported by this driver.
+     *
+     * @see https://www.sqlite.org/isolation.html
+     */
+    static readonly supportedIsolationLevels: IsolationLevel[];
     /**
      * DataSource used by the driver.
      */
     dataSource: DataSource;
+    /**
+     * Isolation levels supported by this driver.
+     */
+    supportedIsolationLevels: ("READ COMMITTED" | "READ UNCOMMITTED" | "REPEATABLE READ" | "SERIALIZABLE" | "SNAPSHOT")[];
     /**
      * DataSource used by the driver.
+     *
      * @deprecated since 1.0.0. Use {@link dataSource} instance instead.
      */
     get connection(): DataSource;
@@ -68,6 +80,7 @@ export declare abstract class AbstractSqliteDriver implements Driver {
     transactionSupport: "simple" | "nested" | "none";
     /**
      * Gets list of supported column data types by a driver.
+     *
      * @see https://www.tutorialspoint.com/sqlite/sqlite_data_types.htm
      * @see https://sqlite.org/datatype3.html
      */
@@ -138,12 +151,14 @@ export declare abstract class AbstractSqliteDriver implements Driver {
     createSchemaBuilder(): RdbmsSchemaBuilder;
     /**
      * Prepares given value to a value to be persisted, based on its column type and metadata.
+     *
      * @param value
      * @param columnMetadata
      */
     preparePersistentValue(value: any, columnMetadata: ColumnMetadata): any;
     /**
      * Prepares given value to a value to be hydrated, based on its column type or metadata.
+     *
      * @param value
      * @param columnMetadata
      */
@@ -151,12 +166,14 @@ export declare abstract class AbstractSqliteDriver implements Driver {
     /**
      * 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: string, parameters: ObjectLiteral): [string, any[]];
     /**
      * Escapes a column name.
+     *
      * @param columnName
      */
     escape(columnName: string): string;
@@ -165,6 +182,7 @@ export declare abstract class AbstractSqliteDriver implements Driver {
      * E.g. myDB.mySchema.myTable
      *
      * Returns only simple table name because all inherited drivers does not supports schema and database.
+     *
      * @param tableName
      * @param schema
      * @param database
@@ -172,6 +190,7 @@ export declare abstract class AbstractSqliteDriver implements Driver {
     buildTableName(tableName: string, schema?: string, database?: string): string;
     /**
      * Parse a target table name or other types and return a normalized table definition.
+     *
      * @param target
      */
     parseTableName(target: EntityMetadata | Table | View | TableForeignKey | string): {
@@ -181,6 +200,7 @@ export declare abstract class AbstractSqliteDriver implements Driver {
     };
     /**
      * Creates a database type from a given column metadata.
+     *
      * @param column
      * @param column.type
      * @param column.length
@@ -195,21 +215,25 @@ export declare abstract class AbstractSqliteDriver implements Driver {
     }): string;
     /**
      * Normalizes "default" value of the column.
+     *
      * @param columnMetadata
      */
     normalizeDefault(columnMetadata: ColumnMetadata): string | undefined;
     /**
      * Normalizes "isUnique" value of the column.
+     *
      * @param column
      */
     normalizeIsUnique(column: ColumnMetadata): boolean;
     /**
      * Calculates column length taking into account the default length values.
+     *
      * @param column
      */
     getColumnLength(column: ColumnMetadata): string;
     /**
      * Normalizes "default" value of the column.
+     *
      * @param column
      */
     createFullType(column: TableColumn): string;
@@ -227,6 +251,7 @@ export declare abstract class AbstractSqliteDriver implements Driver {
     obtainSlaveConnection(): Promise<any>;
     /**
      * Creates generated map of values generated or returned by database after INSERT query.
+     *
      * @param metadata
      * @param insertResult
      * @param entityIndex
@@ -235,12 +260,14 @@ export declare abstract class AbstractSqliteDriver implements Driver {
     createGeneratedMap(metadata: EntityMetadata, insertResult: any, entityIndex: number, entityNum: number): ObjectLiteral | undefined;
     /**
      * Compares json/jsonb default values of the column.
+     *
      * @param columnMetadata
      * @param tableColumn
      */
     private compareJsonDefaults;
     /**
      * Compares "default" value of the column.
+     *
      * @param columnMetadata
      * @param tableColumn
      */
@@ -248,6 +275,7 @@ export declare abstract class AbstractSqliteDriver implements Driver {
     /**
      * Differentiate columns of this table and columns from the given column metadatas columns
      * and returns only changed.
+     *
      * @param tableColumns
      * @param columnMetadatas
      */
@@ -266,12 +294,14 @@ export declare abstract class AbstractSqliteDriver implements Driver {
     isFullTextColumnTypeSupported(): boolean;
     /**
      * Creates an escaped parameter.
+     *
      * @param parameterName
      * @param index
      */
     createParameter(parameterName: string, index: number): string;
     /**
      * Wraps key with json/jsonb function if required.
+     *
      * @param value
      * @param column
      * @param jsonb

package/driver/sqlite-abstract/AbstractSqliteDriver.js

@@ -12,8 +12,21 @@ const DriverUtils_1 = require("../DriverUtils");
  * Organizes communication with sqlite DBMS.
  */
 class AbstractSqliteDriver {
+    // -------------------------------------------------------------------------
+    // Static Properties
+    // -------------------------------------------------------------------------
+    /**
+     * Transaction isolation levels supported by this driver.
+     *
+     * @see https://www.sqlite.org/isolation.html
+     */
+    static { this.supportedIsolationLevels = [
+        "READ UNCOMMITTED",
+        "SERIALIZABLE",
+    ]; }
     /**
      * DataSource used by the driver.
+     *
      * @deprecated since 1.0.0. Use {@link dataSource} instance instead.
      */
     get connection() {
@@ -23,6 +36,10 @@ class AbstractSqliteDriver {
     // Constructor
     // -------------------------------------------------------------------------
     constructor(dataSource) {
+        /**
+         * Isolation levels supported by this driver.
+         */
+        this.supportedIsolationLevels = AbstractSqliteDriver.supportedIsolationLevels;
         /**
          * Indicates if replication is enabled.
          */
@@ -37,6 +54,7 @@ class AbstractSqliteDriver {
         this.transactionSupport = "nested";
         /**
          * Gets list of supported column data types by a driver.
+         *
          * @see https://www.tutorialspoint.com/sqlite/sqlite_data_types.htm
          * @see https://sqlite.org/datatype3.html
          */
@@ -209,6 +227,7 @@ class AbstractSqliteDriver {
     }
     /**
      * Prepares given value to a value to be persisted, based on its column type and metadata.
+     *
      * @param value
      * @param columnMetadata
      */
@@ -250,6 +269,7 @@ class AbstractSqliteDriver {
     }
     /**
      * Prepares given value to a value to be hydrated, based on its column type or metadata.
+     *
      * @param value
      * @param columnMetadata
      */
@@ -318,6 +338,7 @@ class AbstractSqliteDriver {
     /**
      * 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
      */
@@ -361,6 +382,7 @@ class AbstractSqliteDriver {
     }
     /**
      * Escapes a column name.
+     *
      * @param columnName
      */
     escape(columnName) {
@@ -371,6 +393,7 @@ class AbstractSqliteDriver {
      * E.g. myDB.mySchema.myTable
      *
      * Returns only simple table name because all inherited drivers does not supports schema and database.
+     *
      * @param tableName
      * @param schema
      * @param database
@@ -380,6 +403,7 @@ class AbstractSqliteDriver {
     }
     /**
      * Parse a target table name or other types and return a normalized table definition.
+     *
      * @param target
      */
     parseTableName(target) {
@@ -390,26 +414,26 @@ class AbstractSqliteDriver {
                 ? `"${target.schema}"."${target.name}"`
                 : target.name);
             return {
-                database: target.database || parsed.database || driverDatabase,
-                schema: target.schema || parsed.schema || driverSchema,
+                database: target.database ?? parsed.database ?? driverDatabase,
+                schema: target.schema ?? parsed.schema ?? driverSchema,
                 tableName: parsed.tableName,
             };
         }
         if (InstanceChecker_1.InstanceChecker.isTableForeignKey(target)) {
             const parsed = this.parseTableName(target.referencedTableName);
             return {
-                database: target.referencedDatabase ||
-                    parsed.database ||
+                database: target.referencedDatabase ??
+                    parsed.database ??
                     driverDatabase,
-                schema: target.referencedSchema || parsed.schema || driverSchema,
+                schema: target.referencedSchema ?? parsed.schema ?? driverSchema,
                 tableName: parsed.tableName,
             };
         }
         if (InstanceChecker_1.InstanceChecker.isEntityMetadata(target)) {
             // EntityMetadata tableName is never a path
             return {
-                database: target.database || driverDatabase,
-                schema: target.schema || driverSchema,
+                database: target.database ?? driverDatabase,
+                schema: target.schema ?? driverSchema,
                 tableName: target.tableName,
             };
         }
@@ -440,6 +464,7 @@ class AbstractSqliteDriver {
     }
     /**
      * Creates a database type from a given column metadata.
+     *
      * @param column
      * @param column.type
      * @param column.length
@@ -477,6 +502,7 @@ class AbstractSqliteDriver {
     }
     /**
      * Normalizes "default" value of the column.
+     *
      * @param columnMetadata
      */
     normalizeDefault(columnMetadata) {
@@ -511,6 +537,7 @@ class AbstractSqliteDriver {
     }
     /**
      * Normalizes "isUnique" value of the column.
+     *
      * @param column
      */
     normalizeIsUnique(column) {
@@ -518,6 +545,7 @@ class AbstractSqliteDriver {
     }
     /**
      * Calculates column length taking into account the default length values.
+     *
      * @param column
      */
     getColumnLength(column) {
@@ -525,6 +553,7 @@ class AbstractSqliteDriver {
     }
     /**
      * Normalizes "default" value of the column.
+     *
      * @param column
      */
     createFullType(column) {
@@ -567,6 +596,7 @@ class AbstractSqliteDriver {
     }
     /**
      * Creates generated map of values generated or returned by database after INSERT query.
+     *
      * @param metadata
      * @param insertResult
      * @param entityIndex
@@ -591,6 +621,7 @@ class AbstractSqliteDriver {
     }
     /**
      * Compares json/jsonb default values of the column.
+     *
      * @param columnMetadata
      * @param tableColumn
      */
@@ -629,6 +660,7 @@ class AbstractSqliteDriver {
     }
     /**
      * Compares "default" value of the column.
+     *
      * @param columnMetadata
      * @param tableColumn
      */
@@ -647,6 +679,7 @@ class AbstractSqliteDriver {
     /**
      * Differentiate columns of this table and columns from the given column metadatas columns
      * and returns only changed.
+     *
      * @param tableColumns
      * @param columnMetadatas
      */
@@ -667,80 +700,11 @@ class AbstractSqliteDriver {
                 tableColumn.asExpression !== columnMetadata.asExpression ||
                 tableColumn.isUnique !==
                     this.normalizeIsUnique(columnMetadata) ||
-                (tableColumn.enum &&
+                !!(tableColumn.enum &&
                     columnMetadata.enum &&
                     !OrmUtils_1.OrmUtils.isArraysEqual(tableColumn.enum, columnMetadata.enum.map((val) => val + ""))) ||
                 (columnMetadata.generationStrategy !== "uuid" &&
                     tableColumn.isGenerated !== columnMetadata.isGenerated);
-            // DEBUG SECTION
-            // if (isColumnChanged) {
-            //     console.log("table:", columnMetadata.entityMetadata.tableName)
-            //     console.log(
-            //         "name:",
-            //         tableColumn.name,
-            //         columnMetadata.databaseName,
-            //     )
-            //     console.log(
-            //         "type:",
-            //         tableColumn.type,
-            //         this.normalizeType(columnMetadata),
-            //     )
-            //     console.log(
-            //         "length:",
-            //         tableColumn.length,
-            //         columnMetadata.length,
-            //     )
-            //     console.log(
-            //         "precision:",
-            //         tableColumn.precision,
-            //         columnMetadata.precision,
-            //     )
-            //     console.log("scale:", tableColumn.scale, columnMetadata.scale)
-            //     console.log(
-            //         "default:",
-            //         this.normalizeDefault(columnMetadata),
-            //         columnMetadata.default,
-            //     )
-            //     console.log(
-            //         "isPrimary:",
-            //         tableColumn.isPrimary,
-            //         columnMetadata.isPrimary,
-            //     )
-            //     console.log(
-            //         "isNullable:",
-            //         tableColumn.isNullable,
-            //         columnMetadata.isNullable,
-            //     )
-            //     console.log(
-            //         "generatedType:",
-            //         tableColumn.generatedType,
-            //         columnMetadata.generatedType,
-            //     )
-            //     console.log(
-            //         "asExpression:",
-            //         tableColumn.asExpression,
-            //         columnMetadata.asExpression,
-            //     )
-            //     console.log(
-            //         "isUnique:",
-            //         tableColumn.isUnique,
-            //         this.normalizeIsUnique(columnMetadata),
-            //     )
-            //     console.log(
-            //         "enum:",
-            //         tableColumn.enum &&
-            //             columnMetadata.enum &&
-            //             !OrmUtils.isArraysEqual(
-            //                 tableColumn.enum,
-            //                 columnMetadata.enum.map((val) => val + ""),
-            //             ),
-            //     )
-            //     console.log(
-            //         "isGenerated:",
-            //         tableColumn.isGenerated,
-            //         columnMetadata.isGenerated,
-            //     )
-            // }
             return isColumnChanged;
         });
     }
@@ -764,6 +728,7 @@ class AbstractSqliteDriver {
     }
     /**
      * Creates an escaped parameter.
+     *
      * @param parameterName
      * @param index
      */
@@ -774,6 +739,7 @@ class AbstractSqliteDriver {
     }
     /**
      * Wraps key with json/jsonb function if required.
+     *
      * @param value
      * @param column
      * @param jsonb