@lakutata/orm 3.0.0 → 3.1.0

package/dist/vendor/typeorm/driver/spanner/SpannerConnectionCredentialsOptions.js

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

package/dist/vendor/typeorm/driver/spanner/SpannerConnectionCredentialsOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpannerConnectionCredentialsOptions.js","sourceRoot":"","sources":["../../../../../vendor/typeorm/driver/spanner/SpannerConnectionCredentialsOptions.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Spanner specific connection credential options.\n */\nexport interface SpannerConnectionCredentialsOptions {\n    /**\n     * Connection url where the connection is performed.\n     */\n    readonly instanceId?: string\n\n    /**\n     * Database host.\n     */\n    readonly projectId?: string\n\n    /**\n     * Database host port.\n     */\n    readonly databaseId?: string\n\n    /**\n     * Object containing client_email and private_key properties, or the external account client options. Cannot be used with apiKey.\n     */\n    readonly credentials?: {\n        /**\n         * Client email connection credentials (Optional)\n         */\n        readonly client_email: string\n\n        /**\n         * Private key connection credentials (Optional)\n         */\n        readonly private_key: string\n    }\n}\n"]}

package/dist/vendor/typeorm/driver/spanner/SpannerDataSourceOptions.d.ts

@@ -0,0 +1,123 @@
+import type { BaseDataSourceOptions } from "../../data-source/BaseDataSourceOptions";
+import type { ReplicationMode } from "../types/ReplicationMode";
+import type { SpannerConnectionCredentialsOptions } from "./SpannerConnectionCredentialsOptions";
+/**
+ * Spanner specific connection options.
+ */
+export interface SpannerDataSourceOptions extends BaseDataSourceOptions, SpannerConnectionCredentialsOptions {
+    /**
+     * Database type.
+     */
+    readonly type: "spanner";
+    /**
+     * The driver object
+     * This defaults to require("@google-cloud/spanner").
+     */
+    readonly driver?: any;
+    readonly database?: string;
+    readonly schema?: string;
+    /**
+     * The charset for the connection. This is called "collation" in the SQL-level of MySQL (like utf8_general_ci).
+     * If a SQL-level charset is specified (like utf8mb4) then the default collation for that charset is used.
+     * Default: 'UTF8_GENERAL_CI'
+     */
+    readonly charset?: string;
+    /**
+     * The timezone configured on the MySQL server.
+     * This is used to type cast server date/time values to JavaScript Date object and vice versa.
+     * This can be 'local', 'Z', or an offset in the form +HH:MM or -HH:MM. (Default: 'local')
+     */
+    readonly timezone?: string;
+    /**
+     * The milliseconds before a timeout occurs during the initial connection to the MySQL server. (Default: 10000)
+     */
+    readonly connectTimeout?: number;
+    /**
+     * The milliseconds before a timeout occurs during the initial connection to the MySQL server. (Default: 10000)
+     * This difference between connectTimeout and acquireTimeout is subtle and is described in the mysqljs/mysql docs
+     * https://github.com/mysqljs/mysql/tree/master#pool-options
+     */
+    readonly acquireTimeout?: number;
+    /**
+     * Allow connecting to MySQL instances that ask for the old (insecure) authentication method. (Default: false)
+     */
+    readonly insecureAuth?: boolean;
+    /**
+     * When dealing with big numbers (BIGINT and DECIMAL columns) in the database, you should enable this option (Default: false)
+     */
+    readonly supportBigNumbers?: boolean;
+    /**
+     * Enabling both supportBigNumbers and bigNumberStrings forces big numbers (BIGINT and DECIMAL columns) to be always
+     * returned as JavaScript String objects (Default: false). Enabling supportBigNumbers but leaving bigNumberStrings
+     * disabled will return big numbers as String objects only when they cannot be accurately represented with
+     * [JavaScript Number objects](http://ecma262-5.com/ELS5_HTML.htm#Section_8.5) (which happens when they exceed the [-2^53, +2^53] range),
+     * otherwise they will be returned as Number objects. This option is ignored if supportBigNumbers is disabled.
+     */
+    readonly bigNumberStrings?: boolean;
+    /**
+     * Force date types (TIMESTAMP, DATETIME, DATE) to be returned as strings rather then inflated into JavaScript Date objects.
+     * Can be true/false or an array of type names to keep as strings.
+     */
+    readonly dateStrings?: boolean | string[];
+    /**
+     * Prints protocol details to stdout. Can be true/false or an array of packet type names that should be printed.
+     * (Default: false)
+     */
+    readonly debug?: boolean | string[];
+    /**
+     * Generates stack traces on Error to include call site of library entrance ("long stack traces").
+     * Slight performance penalty for most calls. (Default: true)
+     */
+    readonly trace?: boolean;
+    /**
+     * Allow multiple mysql statements per query. Be careful with this, it could increase the scope of SQL injection attacks.
+     * (Default: false)
+     */
+    readonly multipleStatements?: boolean;
+    /**
+     * List of connection flags to use other than the default ones. It is also possible to blacklist default ones.
+     * For more information, check https://github.com/mysqljs/mysql#connection-flags.
+     */
+    readonly flags?: string[];
+    /**
+     * Replication setup.
+     */
+    readonly replication?: {
+        /**
+         * Master server used by orm to perform writes.
+         */
+        readonly master: SpannerConnectionCredentialsOptions;
+        /**
+         * List of read-from servers (slaves).
+         */
+        readonly slaves: SpannerConnectionCredentialsOptions[];
+        /**
+         * If true, PoolCluster will attempt to reconnect when connection fails. (Default: true)
+         */
+        readonly canRetry?: boolean;
+        /**
+         * If connection fails, node's errorCount increases.
+         * When errorCount is greater than removeNodeErrorCount, remove a node in the PoolCluster. (Default: 5)
+         */
+        readonly removeNodeErrorCount?: number;
+        /**
+         * If connection fails, specifies the number of milliseconds before another connection attempt will be made.
+         * If set to 0, then node will be removed instead and never re-used. (Default: 0)
+         */
+        readonly restoreNodeTimeout?: number;
+        /**
+         * Determines how slaves are selected:
+         * RR: Select one alternately (Round-Robin).
+         * RANDOM: Select the node by random function.
+         * ORDER: Select the first node available unconditionally.
+         */
+        readonly selector?: "RR" | "RANDOM" | "ORDER";
+        /**
+         * Default connection pool to use for SELECT queries
+         *
+         * @default "slave"
+         */
+        readonly defaultMode?: ReplicationMode;
+    };
+    readonly poolSize?: never;
+}

package/dist/vendor/typeorm/driver/spanner/SpannerDataSourceOptions.js

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

package/dist/vendor/typeorm/driver/spanner/SpannerDataSourceOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpannerDataSourceOptions.js","sourceRoot":"","sources":["../../../../../vendor/typeorm/driver/spanner/SpannerDataSourceOptions.ts"],"names":[],"mappings":"","sourcesContent":["import type { BaseDataSourceOptions } from \"../../data-source/BaseDataSourceOptions\"\nimport type { ReplicationMode } from \"../types/ReplicationMode\"\nimport type { SpannerConnectionCredentialsOptions } from \"./SpannerConnectionCredentialsOptions\"\n\n/**\n * Spanner specific connection options.\n */\nexport interface SpannerDataSourceOptions\n    extends BaseDataSourceOptions, SpannerConnectionCredentialsOptions {\n    /**\n     * Database type.\n     */\n    readonly type: \"spanner\"\n\n    /**\n     * The driver object\n     * This defaults to require(\"@google-cloud/spanner\").\n     */\n    readonly driver?: any\n\n    // todo\n    readonly database?: string\n\n    // todo\n    readonly schema?: string\n\n    /**\n     * The charset for the connection. This is called \"collation\" in the SQL-level of MySQL (like utf8_general_ci).\n     * If a SQL-level charset is specified (like utf8mb4) then the default collation for that charset is used.\n     * Default: 'UTF8_GENERAL_CI'\n     */\n    readonly charset?: string\n\n    /**\n     * The timezone configured on the MySQL server.\n     * This is used to type cast server date/time values to JavaScript Date object and vice versa.\n     * This can be 'local', 'Z', or an offset in the form +HH:MM or -HH:MM. (Default: 'local')\n     */\n    readonly timezone?: string\n\n    /**\n     * The milliseconds before a timeout occurs during the initial connection to the MySQL server. (Default: 10000)\n     */\n    readonly connectTimeout?: number\n\n    /**\n     * The milliseconds before a timeout occurs during the initial connection to the MySQL server. (Default: 10000)\n     * This difference between connectTimeout and acquireTimeout is subtle and is described in the mysqljs/mysql docs\n     * https://github.com/mysqljs/mysql/tree/master#pool-options\n     */\n    readonly acquireTimeout?: number\n\n    /**\n     * Allow connecting to MySQL instances that ask for the old (insecure) authentication method. (Default: false)\n     */\n    readonly insecureAuth?: boolean\n\n    /**\n     * When dealing with big numbers (BIGINT and DECIMAL columns) in the database, you should enable this option (Default: false)\n     */\n    readonly supportBigNumbers?: boolean\n\n    /**\n     * Enabling both supportBigNumbers and bigNumberStrings forces big numbers (BIGINT and DECIMAL columns) to be always\n     * returned as JavaScript String objects (Default: false). Enabling supportBigNumbers but leaving bigNumberStrings\n     * disabled will return big numbers as String objects only when they cannot be accurately represented with\n     * [JavaScript Number objects](http://ecma262-5.com/ELS5_HTML.htm#Section_8.5) (which happens when they exceed the [-2^53, +2^53] range),\n     * otherwise they will be returned as Number objects. This option is ignored if supportBigNumbers is disabled.\n     */\n    readonly bigNumberStrings?: boolean\n\n    /**\n     * Force date types (TIMESTAMP, DATETIME, DATE) to be returned as strings rather then inflated into JavaScript Date objects.\n     * Can be true/false or an array of type names to keep as strings.\n     */\n    readonly dateStrings?: boolean | string[]\n\n    /**\n     * Prints protocol details to stdout. Can be true/false or an array of packet type names that should be printed.\n     * (Default: false)\n     */\n    readonly debug?: boolean | string[]\n\n    /**\n     * Generates stack traces on Error to include call site of library entrance (\"long stack traces\").\n     * Slight performance penalty for most calls. (Default: true)\n     */\n    readonly trace?: boolean\n\n    /**\n     * Allow multiple mysql statements per query. Be careful with this, it could increase the scope of SQL injection attacks.\n     * (Default: false)\n     */\n    readonly multipleStatements?: boolean\n\n    /**\n     * List of connection flags to use other than the default ones. It is also possible to blacklist default ones.\n     * For more information, check https://github.com/mysqljs/mysql#connection-flags.\n     */\n    readonly flags?: string[]\n\n    /**\n     * Replication setup.\n     */\n    readonly replication?: {\n        /**\n         * Master server used by orm to perform writes.\n         */\n        readonly master: SpannerConnectionCredentialsOptions\n\n        /**\n         * List of read-from servers (slaves).\n         */\n        readonly slaves: SpannerConnectionCredentialsOptions[]\n\n        /**\n         * If true, PoolCluster will attempt to reconnect when connection fails. (Default: true)\n         */\n        readonly canRetry?: boolean\n\n        /**\n         * If connection fails, node's errorCount increases.\n         * When errorCount is greater than removeNodeErrorCount, remove a node in the PoolCluster. (Default: 5)\n         */\n        readonly removeNodeErrorCount?: number\n\n        /**\n         * If connection fails, specifies the number of milliseconds before another connection attempt will be made.\n         * If set to 0, then node will be removed instead and never re-used. (Default: 0)\n         */\n        readonly restoreNodeTimeout?: number\n\n        /**\n         * Determines how slaves are selected:\n         * RR: Select one alternately (Round-Robin).\n         * RANDOM: Select the node by random function.\n         * ORDER: Select the first node available unconditionally.\n         */\n        readonly selector?: \"RR\" | \"RANDOM\" | \"ORDER\"\n\n        /**\n         * Default connection pool to use for SELECT queries\n         *\n         * @default \"slave\"\n         */\n        readonly defaultMode?: ReplicationMode\n    }\n\n    readonly poolSize?: never\n}\n"]}

package/dist/vendor/typeorm/driver/spanner/SpannerDriver.d.ts

@@ -0,0 +1,302 @@
+import type { ObjectLiteral } from "../../common/ObjectLiteral";
+import type { DataSource } from "../../data-source";
+import type { ColumnMetadata } from "../../metadata/ColumnMetadata";
+import { EntityMetadata } from "../../metadata/EntityMetadata";
+import { RdbmsSchemaBuilder } from "../../schema-builder/RdbmsSchemaBuilder";
+import { Table } from "../../schema-builder/table/Table";
+import type { TableColumn } from "../../schema-builder/table/TableColumn";
+import { TableForeignKey } from "../../schema-builder/table/TableForeignKey";
+import { View } from "../../schema-builder/view/View";
+import type { Driver } from "../Driver";
+import type { ColumnType } from "../types/ColumnTypes";
+import type { CteCapabilities } from "../types/CteCapabilities";
+import type { DataTypeDefaults } from "../types/DataTypeDefaults";
+import type { IsolationLevel } from "../types/IsolationLevel";
+import type { MappedColumnTypes } from "../types/MappedColumnTypes";
+import type { ReplicationMode } from "../types/ReplicationMode";
+import type { ReturningType } from "../types/ReturningType";
+import type { UpsertType } from "../types/UpsertType";
+import type { SpannerDataSourceOptions } from "./SpannerDataSourceOptions";
+import { SpannerQueryRunner } from "./SpannerQueryRunner";
+/**
+ * Organizes communication with Spanner DBMS.
+ */
+export declare class SpannerDriver implements Driver {
+    /**
+     * Transaction isolation levels supported by this driver.
+     *
+     * @see https://cloud.google.com/spanner/docs/isolation-levels
+     */
+    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;
+    /**
+     * Cloud Spanner underlying library.
+     */
+    spanner: any;
+    /**
+     * Cloud Spanner instance.
+     */
+    instance: any;
+    /**
+     * Cloud Spanner database.
+     */
+    instanceDatabase: any;
+    /**
+     * Database name.
+     */
+    database?: string;
+    /**
+     * DataSource options.
+     */
+    options: SpannerDataSourceOptions;
+    /**
+     * 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: "none";
+    /**
+     * Gets list of supported column data types by a driver.
+     *
+     * @see https://cloud.google.com/spanner/docs/reference/standard-sql/data-types
+     */
+    supportedDataTypes: ColumnType[];
+    /**
+     * Returns type of upsert supported by driver if any
+     */
+    supportedUpsertTypes: UpsertType[];
+    /**
+     * 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 supports scale by a driver.
+     */
+    withScaleColumnTypes: ColumnType[];
+    /**
+     * ORM has special columns and we need to know what database column types should be for those columns.
+     * Column types are driver dependant.
+     */
+    mappedDataTypes: MappedColumnTypes;
+    /**
+     * The prefix used for the parameters
+     */
+    parametersPrefix: string;
+    /**
+     * 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;
+    /**
+     * Max length allowed by MySQL for aliases.
+     *
+     * @see https://dev.mysql.com/doc/refman/5.5/en/identifiers.html
+     */
+    maxAliasLength: number;
+    cteCapabilities: CteCapabilities;
+    constructor(dataSource: DataSource);
+    /**
+     * Performs connection to the database.
+     */
+    connect(): Promise<void>;
+    /**
+     * Makes any action after connection (e.g. create extensions in Postgres driver).
+     */
+    afterConnect(): Promise<void>;
+    /**
+     * Closes connection with the database.
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Creates a schema builder used to build and sync a schema.
+     */
+    createSchemaBuilder(): RdbmsSchemaBuilder;
+    /**
+     * Creates a query runner used to execute database queries.
+     *
+     * @param mode
+     */
+    createQueryRunner(mode: ReplicationMode): SpannerQueryRunner;
+    /**
+     * 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;
+    /**
+     * 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: 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): {
+        database?: string;
+        schema?: string;
+        tableName: string;
+    };
+    /**
+     * 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 persisted, based on its column type or metadata.
+     *
+     * @param value
+     * @param columnMetadata
+     */
+    prepareHydratedValue(value: any, columnMetadata: ColumnMetadata): any;
+    /**
+     * 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: {
+        type: ColumnType;
+        length?: number | string;
+        precision?: number | null;
+        scale?: number;
+    }): string;
+    /**
+     * Normalizes "default" value of the column.
+     *
+     * Spanner does not support default values.
+     *
+     * @param columnMetadata
+     */
+    normalizeDefault(columnMetadata: ColumnMetadata): string | undefined;
+    /**
+     * Normalizes "isUnique" value of the column.
+     *
+     * @param column
+     */
+    normalizeIsUnique(column: ColumnMetadata): boolean;
+    /**
+     * Returns default column lengths, which is required on column creation.
+     *
+     * @param column
+     */
+    getColumnLength(column: ColumnMetadata | TableColumn): string;
+    /**
+     * Creates column type definition including length, precision and scale
+     *
+     * @param 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.
+     *
+     * @param metadata
+     * @param insertResult
+     * @param entityIndex
+     */
+    createGeneratedMap(metadata: EntityMetadata, insertResult: any, entityIndex: number): ObjectLiteral | undefined;
+    /**
+     * Differentiate columns of this table and columns from the given column metadatas columns
+     * and returns only changed.
+     *
+     * @param tableColumns
+     * @param columnMetadatas
+     */
+    findChangedColumns(tableColumns: TableColumn[], columnMetadatas: ColumnMetadata[]): ColumnMetadata[];
+    /**
+     * Returns true if driver supports RETURNING / OUTPUT statement.
+     *
+     * @param _returningType
+     */
+    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.
+     *
+     * @param parameterName
+     * @param index
+     */
+    createParameter(parameterName: string, index: number): string;
+    /**
+     * Loads all driver dependencies.
+     */
+    protected loadDependencies(): void;
+    compareNullableValues(columnMetadata: ColumnMetadata, tableColumn: TableColumn): boolean;
+    /**
+     * Checks if "DEFAULT" values in the column metadata and in the database are equal.
+     *
+     * @param columnMetadataValue
+     * @param databaseValue
+     */
+    protected compareDefaultValues(columnMetadataValue: string | undefined, databaseValue: string | undefined): boolean;
+    /**
+     * Escapes a given comment.
+     *
+     * @param comment
+     */
+    protected escapeComment(comment?: string): string | undefined;
+}