@lakutata/orm 3.0.0 → 3.1.1

package/dist/vendor/typeorm/driver/sap/SapDriver.js

@@ -0,0 +1,761 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SapDriver = void 0;
+const node_util_1 = require("node:util");
+const ConnectionIsNotSetError_1 = require("../../error/ConnectionIsNotSetError");
+const DriverPackageNotInstalledError_1 = require("../../error/DriverPackageNotInstalledError");
+const TypeORMError_1 = require("../../error/TypeORMError");
+const PlatformTools_1 = require("../../platform/PlatformTools");
+const RdbmsSchemaBuilder_1 = require("../../schema-builder/RdbmsSchemaBuilder");
+const ApplyValueTransformers_1 = require("../../util/ApplyValueTransformers");
+const DateUtils_1 = require("../../util/DateUtils");
+const InstanceChecker_1 = require("../../util/InstanceChecker");
+const OrmUtils_1 = require("../../util/OrmUtils");
+const DriverUtils_1 = require("../DriverUtils");
+const SapQueryRunner_1 = require("./SapQueryRunner");
+class SapDriver {
+    // -------------------------------------------------------------------------
+    // Static Properties
+    // -------------------------------------------------------------------------
+    /**
+     * Transaction isolation levels supported by this driver.
+     *
+     * @see https://help.sap.com/docs/SAP_HANA_PLATFORM/4fe29514fd584807ac9f2a04f6754767/d91cbe21f56e4b82b3b7e4ff2b35acf8.html
+     */
+    static { this.supportedIsolationLevels = [
+        "READ COMMITTED",
+        "REPEATABLE READ",
+        "SERIALIZABLE",
+    ]; }
+    /**
+     * DataSource used by the driver.
+     *
+     * @deprecated since 1.0.0. Use {@link dataSource} instance instead.
+     */
+    get connection() {
+        return this.dataSource;
+    }
+    // -------------------------------------------------------------------------
+    // Constructor
+    // -------------------------------------------------------------------------
+    constructor(dataSource) {
+        /**
+         * Isolation levels supported by this driver.
+         */
+        this.supportedIsolationLevels = SapDriver.supportedIsolationLevels;
+        /**
+         * Indicates if replication is enabled.
+         */
+        this.isReplicated = false;
+        /**
+         * Indicates if tree tables are supported by this driver.
+         */
+        this.treeSupport = true;
+        /**
+         * Represent transaction support by this driver
+         */
+        this.transactionSupport = "simple";
+        /**
+         * Gets list of supported column data types by a driver.
+         *
+         * @see https://help.sap.com/docs/SAP_HANA_PLATFORM/4fe29514fd584807ac9f2a04f6754767/20a1569875191014b507cf392724b7eb.html
+         * @see https://help.sap.com/docs/hana-cloud-database/sap-hana-cloud-sap-hana-database-sql-reference-guide/data-types
+         */
+        this.supportedDataTypes = [
+            "alphanum", // removed in SAP HANA Cloud
+            "array",
+            "bigint",
+            "binary",
+            "blob",
+            "boolean",
+            "char", // not officially supported, in SAP HANA Cloud: alias for "nchar"
+            "clob", // in SAP HANA Cloud: alias for "nclob"
+            "date",
+            "dec", // typeorm alias for "decimal"
+            "decimal",
+            "double",
+            "float", // database alias for "real" / "double"
+            "half_vector", // only supported in SAP HANA Cloud, not in SAP HANA 2.0
+            "int", // typeorm alias for "integer"
+            "integer",
+            "nchar", // not officially supported
+            "nclob",
+            "nvarchar",
+            "real_vector", // only supported in SAP HANA Cloud, not in SAP HANA 2.0
+            "real",
+            "seconddate",
+            "shorttext", // removed in SAP HANA Cloud
+            "smalldecimal",
+            "smallint",
+            "st_geometry",
+            "st_point",
+            "text", // removed in SAP HANA Cloud
+            "time",
+            "timestamp",
+            "tinyint",
+            "varbinary",
+            "varchar", // in SAP HANA Cloud: alias for "nvarchar"
+        ];
+        /**
+         * Returns type of upsert supported by driver if any
+         */
+        this.supportedUpsertTypes = ["merge-into"];
+        /**
+         * Gets list of spatial column data types.
+         */
+        this.spatialTypes = ["st_geometry", "st_point"];
+        /**
+         * Gets list of column data types that support length by a driver.
+         */
+        this.withLengthColumnTypes = [
+            "alphanum",
+            "binary",
+            "half_vector",
+            "nvarchar",
+            "real_vector",
+            "shorttext",
+            "varbinary",
+            "varchar",
+        ];
+        /**
+         * Gets list of column data types that support precision by a driver.
+         */
+        this.withPrecisionColumnTypes = ["decimal"];
+        /**
+         * Gets list of column data types that support scale by a driver.
+         */
+        this.withScaleColumnTypes = ["decimal", "timestamp"];
+        /**
+         * Orm has special columns and we need to know what database column types should be for those types.
+         * Column types are driver dependant.
+         */
+        this.mappedDataTypes = {
+            createDate: "timestamp",
+            createDateDefault: "CURRENT_TIMESTAMP",
+            updateDate: "timestamp",
+            updateDateDefault: "CURRENT_TIMESTAMP",
+            deleteDate: "timestamp",
+            deleteDateNullable: true,
+            version: "integer",
+            treeLevel: "integer",
+            migrationId: "integer",
+            migrationName: "nvarchar",
+            migrationTimestamp: "bigint",
+            cacheId: "integer",
+            cacheIdentifier: "nvarchar",
+            cacheTime: "bigint",
+            cacheDuration: "integer",
+            cacheQuery: "nvarchar(5000)",
+            cacheResult: "nclob",
+            metadataType: "nvarchar",
+            metadataDatabase: "nvarchar",
+            metadataSchema: "nvarchar",
+            metadataTable: "nvarchar",
+            metadataName: "nvarchar",
+            metadataValue: "nvarchar(5000)",
+        };
+        /**
+         * 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.
+         */
+        this.dataTypeDefaults = {
+            binary: { length: 1 },
+            char: { length: 1 },
+            decimal: { precision: 18, scale: 0 },
+            nchar: { length: 1 },
+            nvarchar: { length: 255 },
+            shorttext: { length: 255 },
+            varbinary: { length: 255 },
+            varchar: { length: 255 },
+        };
+        /**
+         * Max length allowed by SAP HANA for aliases (identifiers).
+         *
+         * @see https://help.sap.com/docs/hana-cloud-database/sap-hana-cloud-sap-hana-database-sql-reference-guide/system-limitations
+         */
+        this.maxAliasLength = 128;
+        this.cteCapabilities = {
+            enabled: true,
+        };
+        this.dummyTableName = `SYS.DUMMY`;
+        this.dataSource = dataSource;
+        this.options = dataSource.options;
+        this.loadDependencies();
+        this.database = DriverUtils_1.DriverUtils.buildDriverOptions(this.options).database;
+        this.schema = DriverUtils_1.DriverUtils.buildDriverOptions(this.options).schema;
+    }
+    // -------------------------------------------------------------------------
+    // Public Implemented Methods
+    // -------------------------------------------------------------------------
+    /**
+     * Performs connection to the database.
+     * Based on pooling options, it can either create connection immediately,
+     * either create a pool and create connection when needed.
+     */
+    async connect() {
+        // HANA connection info
+        const connectionOptions = {
+            host: this.options.host,
+            port: this.options.port,
+            user: this.options.username,
+            password: this.options.password,
+            database: this.options.database,
+            currentSchema: this.options.schema,
+            encrypt: this.options.encrypt,
+            sslValidateCertificate: this.options.sslValidateCertificate,
+            key: this.options.key,
+            cert: this.options.cert,
+            ca: this.options.ca,
+        };
+        Object.keys(connectionOptions).forEach((key) => {
+            if (connectionOptions[key] === undefined) {
+                delete connectionOptions[key];
+            }
+        });
+        Object.assign(connectionOptions, this.options.extra ?? {});
+        // pool options
+        const poolOptions = {
+            maxConnectedOrPooled: this.options.pool?.maxConnectedOrPooled ??
+                this.options.poolSize ??
+                10,
+            maxPooledIdleTime: this.options.pool?.maxPooledIdleTime ?? 30,
+            maxWaitTimeoutIfPoolExhausted: this.options.pool?.maxWaitTimeoutIfPoolExhausted ?? 0,
+        };
+        if (this.options.pool?.pingCheck) {
+            poolOptions.pingCheck = this.options.pool.pingCheck;
+        }
+        if (this.options.pool?.poolCapacity) {
+            poolOptions.poolCapacity = this.options.pool.poolCapacity;
+        }
+        this.poolErrorHandler =
+            this.options.pool?.poolErrorHandler ??
+                ((error) => {
+                    this.dataSource.logger.log("warn", `SAP HANA pool raised an error: ${error}`);
+                });
+        // create the pool
+        try {
+            this.master = this.client.createPool(connectionOptions, poolOptions);
+        }
+        catch (error) {
+            this.poolErrorHandler(error);
+            throw error;
+        }
+        const queryRunner = this.createQueryRunner("master");
+        const { version, database } = await queryRunner.getDatabaseAndVersion();
+        this.version = version;
+        this.database = database;
+        this.schema ??= await queryRunner.getCurrentSchema();
+        await queryRunner.release();
+    }
+    /**
+     * Makes any action after connection (e.g. create extensions in Postgres driver).
+     */
+    afterConnect() {
+        return Promise.resolve();
+    }
+    /**
+     * Closes connection with the database.
+     */
+    async disconnect() {
+        const pool = this.master;
+        if (!pool) {
+            throw new ConnectionIsNotSetError_1.ConnectionIsNotSetError("sap");
+        }
+        this.master = undefined;
+        try {
+            await (0, node_util_1.promisify)(pool.clear).call(pool);
+        }
+        catch (error) {
+            this.poolErrorHandler(error);
+            throw error;
+        }
+    }
+    /**
+     * Obtains a new database connection to a master server.
+     * Used for replication.
+     * If replication is not setup then returns default connection's database connection.
+     */
+    async obtainMasterConnection() {
+        const pool = this.master;
+        if (!pool) {
+            throw new TypeORMError_1.TypeORMError("Driver not Connected");
+        }
+        try {
+            return await (0, node_util_1.promisify)(pool.getConnection).call(pool);
+        }
+        catch (error) {
+            this.poolErrorHandler(error);
+            throw error;
+        }
+    }
+    /**
+     * 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.
+     */
+    async obtainSlaveConnection() {
+        return this.obtainMasterConnection();
+    }
+    /**
+     * Creates a schema builder used to build and sync a schema.
+     */
+    createSchemaBuilder() {
+        return new RdbmsSchemaBuilder_1.RdbmsSchemaBuilder(this.dataSource);
+    }
+    /**
+     * Creates a query runner used to execute database queries.
+     *
+     * @param mode
+     */
+    createQueryRunner(mode) {
+        return new SapQueryRunner_1.SapQueryRunner(this, mode);
+    }
+    /**
+     * Replaces parameters in the given sql with special escaping character
+     * and an array of parameter names to be passed to a query.
+     *
+     * @param sql
+     * @param parameters
+     */
+    escapeQueryWithParameters(sql, parameters) {
+        const escapedParameters = [];
+        if (!parameters || !Object.keys(parameters).length)
+            return [sql, escapedParameters];
+        sql = sql.replaceAll(/:(\.\.\.)?([A-Za-z0-9_.]+)/g, (full, isArray, key) => {
+            if (!parameters.hasOwnProperty(key)) {
+                return full;
+            }
+            const value = parameters[key];
+            if (isArray) {
+                return value
+                    .map((v) => {
+                    escapedParameters.push(v);
+                    return this.createParameter(key, escapedParameters.length - 1);
+                })
+                    .join(", ");
+            }
+            if (typeof value === "function") {
+                return value();
+            }
+            escapedParameters.push(value);
+            return this.createParameter(key, escapedParameters.length - 1);
+        }); // todo: make replace only in value statements, otherwise problems
+        return [sql, escapedParameters];
+    }
+    /**
+     * Escapes a column name.
+     *
+     * @param columnName
+     */
+    escape(columnName) {
+        return `"${columnName.replaceAll('"', '""')}"`;
+    }
+    /**
+     * Build full table name with schema name and table name.
+     * E.g. myDB.mySchema.myTable
+     *
+     * @param tableName
+     * @param schema
+     */
+    buildTableName(tableName, schema) {
+        const tablePath = [tableName];
+        if (schema) {
+            tablePath.unshift(schema);
+        }
+        return tablePath.join(".");
+    }
+    /**
+     * Parse a target table name or other types and return a normalized table definition.
+     *
+     * @param target
+     */
+    parseTableName(target) {
+        const driverDatabase = this.database;
+        const driverSchema = this.schema;
+        if (InstanceChecker_1.InstanceChecker.isTable(target) || InstanceChecker_1.InstanceChecker.isView(target)) {
+            const parsed = this.parseTableName(target.name);
+            return {
+                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 ??
+                    driverDatabase,
+                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,
+                tableName: target.tableName,
+            };
+        }
+        const parts = target.split(".");
+        return {
+            database: driverDatabase,
+            schema: (parts.length > 1 ? parts[0] : undefined) ?? driverSchema,
+            tableName: parts.length > 1 ? parts[1] : parts[0],
+        };
+    }
+    /**
+     * Prepares given value to a value to be persisted, based on its column type and metadata.
+     *
+     * @param value
+     * @param columnMetadata
+     */
+    preparePersistentValue(value, columnMetadata) {
+        if (columnMetadata.transformer)
+            value = ApplyValueTransformers_1.ApplyValueTransformers.transformTo(columnMetadata.transformer, value);
+        if (value === null || value === undefined)
+            return value;
+        if (columnMetadata.type === "date") {
+            return DateUtils_1.DateUtils.mixedDateToDateString(value, {
+                utc: columnMetadata.utc,
+            });
+        }
+        else if (columnMetadata.type === "time") {
+            return DateUtils_1.DateUtils.mixedDateToTimeString(value);
+        }
+        else if (columnMetadata.type === "timestamp" ||
+            columnMetadata.type === Date) {
+            return DateUtils_1.DateUtils.mixedDateToDatetimeString(value, true);
+        }
+        else if (columnMetadata.type === "seconddate") {
+            return DateUtils_1.DateUtils.mixedDateToDatetimeString(value, false);
+        }
+        else if (columnMetadata.type === "simple-array") {
+            return DateUtils_1.DateUtils.simpleArrayToString(value);
+        }
+        else if (columnMetadata.type === "simple-json") {
+            return DateUtils_1.DateUtils.simpleJsonToString(value);
+        }
+        else if (columnMetadata.type === "simple-enum") {
+            return DateUtils_1.DateUtils.simpleEnumToString(value);
+        }
+        else if (columnMetadata.isArray) {
+            return () => `ARRAY(${value.map((it) => `'${it}'`)})`;
+        }
+        return value;
+    }
+    /**
+     * Prepares given value to a value to be persisted, based on its column type or metadata.
+     *
+     * @param value
+     * @param columnMetadata
+     */
+    prepareHydratedValue(value, columnMetadata) {
+        if (value === null || value === undefined)
+            return columnMetadata.transformer
+                ? ApplyValueTransformers_1.ApplyValueTransformers.transformFrom(columnMetadata.transformer, value)
+                : value;
+        if (columnMetadata.type === "timestamp" ||
+            columnMetadata.type === "seconddate" ||
+            columnMetadata.type === Date) {
+            value = DateUtils_1.DateUtils.normalizeHydratedDate(value);
+        }
+        else if (columnMetadata.type === "date") {
+            value = DateUtils_1.DateUtils.mixedDateToDateString(value, {
+                utc: columnMetadata.utc,
+            });
+        }
+        else if (columnMetadata.type === "time") {
+            value = DateUtils_1.DateUtils.mixedTimeToString(value);
+        }
+        else if (columnMetadata.type === "simple-array") {
+            value = DateUtils_1.DateUtils.stringToSimpleArray(value);
+        }
+        else if (columnMetadata.type === "simple-json") {
+            value = DateUtils_1.DateUtils.stringToSimpleJson(value);
+        }
+        else if (columnMetadata.type === "simple-enum") {
+            value = DateUtils_1.DateUtils.stringToSimpleEnum(value, columnMetadata);
+        }
+        if (columnMetadata.transformer)
+            value = ApplyValueTransformers_1.ApplyValueTransformers.transformFrom(columnMetadata.transformer, value);
+        return value;
+    }
+    /**
+     * Creates a database type from a given column metadata.
+     *
+     * @param column
+     * @param column.type
+     * @param column.length
+     * @param column.precision
+     * @param column.scale
+     */
+    normalizeType(column) {
+        if (column.type === Number || column.type === "int") {
+            return "integer";
+        }
+        else if (column.type === "dec") {
+            return "decimal";
+        }
+        else if (column.type === "float") {
+            const length = typeof column.length === "string"
+                ? parseInt(column.length)
+                : column.length;
+            // https://help.sap.com/docs/SAP_HANA_PLATFORM/4fe29514fd584807ac9f2a04f6754767/4ee2f261e9c44003807d08ccc2e249ac.html
+            if (length && length < 25) {
+                return "real";
+            }
+            return "double";
+        }
+        else if (column.type === String) {
+            return "nvarchar";
+        }
+        else if (column.type === Date) {
+            return "timestamp";
+        }
+        else if (column.type === Boolean) {
+            return "boolean";
+        }
+        else if (typeof column.type === "function" &&
+            column.type.prototype instanceof Uint8Array) {
+            return "blob";
+        }
+        else if (column.type === "uuid") {
+            return "nvarchar";
+        }
+        else if (column.type === "simple-array" ||
+            column.type === "simple-json") {
+            return "nclob";
+        }
+        else if (column.type === "simple-enum") {
+            return "nvarchar";
+        }
+        else if (column.type === "vector") {
+            return "real_vector";
+        }
+        else if (column.type === "halfvec") {
+            return "half_vector";
+        }
+        if (DriverUtils_1.DriverUtils.isReleaseVersionOrGreater(this, "4.0")) {
+            // SAP HANA Cloud deprecated / removed these data types
+            if (column.type === "varchar" ||
+                column.type === "alphanum" ||
+                column.type === "shorttext") {
+                return "nvarchar";
+            }
+            else if (column.type === "text" || column.type === "clob") {
+                return "nclob";
+            }
+            else if (column.type === "char") {
+                return "nchar";
+            }
+        }
+        else {
+            if (column.type === "real_vector" ||
+                column.type === "half_vector") {
+                return "varbinary";
+            }
+        }
+        return column.type || "";
+    }
+    /**
+     * Normalizes "default" value of the column.
+     *
+     * @param columnMetadata
+     */
+    normalizeDefault(columnMetadata) {
+        const defaultValue = columnMetadata.default;
+        if (typeof defaultValue === "number") {
+            return `${defaultValue}`;
+        }
+        if (typeof defaultValue === "boolean") {
+            return defaultValue ? "true" : "false";
+        }
+        if (typeof defaultValue === "function") {
+            return defaultValue();
+        }
+        if (typeof defaultValue === "string") {
+            return `'${defaultValue}'`;
+        }
+        if (defaultValue === null || defaultValue === undefined) {
+            return undefined;
+        }
+        return `${defaultValue}`;
+    }
+    /**
+     * Normalizes "isUnique" value of the column.
+     *
+     * @param column
+     */
+    normalizeIsUnique(column) {
+        return column.entityMetadata.indices.some((idx) => idx.isUnique &&
+            idx.columns.length === 1 &&
+            idx.columns[0] === column);
+    }
+    /**
+     * Returns default column lengths, which is required on column creation.
+     *
+     * @param column
+     */
+    getColumnLength(column) {
+        if (column.length)
+            return column.length.toString();
+        if (column.generationStrategy === "uuid")
+            return "36";
+        switch (column.type) {
+            case "varchar":
+            case "nvarchar":
+            case "shorttext":
+            case String:
+                return "255";
+            case "alphanum":
+                return "127";
+            case "varbinary":
+                return "255";
+        }
+        return "";
+    }
+    /**
+     * Creates column type definition including length, precision and scale
+     *
+     * @param column
+     */
+    createFullType(column) {
+        let type = column.type;
+        // used 'getColumnLength()' method, because SqlServer sets `varchar` and `nvarchar` length to 1 by default.
+        if (this.getColumnLength(column)) {
+            type += `(${this.getColumnLength(column)})`;
+        }
+        else if (column.precision !== null &&
+            column.precision !== undefined &&
+            column.scale !== null &&
+            column.scale !== undefined) {
+            type += `(${column.precision},${column.scale})`;
+        }
+        else if (column.precision !== null &&
+            column.precision !== undefined) {
+            type += `(${column.precision})`;
+        }
+        if (column.isArray)
+            type += " array";
+        return type;
+    }
+    /**
+     * Creates generated map of values generated or returned by database after INSERT query.
+     *
+     * @param metadata
+     * @param insertResult
+     */
+    createGeneratedMap(metadata, insertResult) {
+        const generatedMap = metadata.generatedColumns.reduce((map, generatedColumn) => {
+            let value;
+            if (generatedColumn.generationStrategy === "increment" &&
+                insertResult) {
+                value = insertResult;
+                // } else if (generatedColumn.generationStrategy === "uuid") {
+                //     console.log("getting db value:", generatedColumn.databaseName);
+                //     value = generatedColumn.getEntityValue(uuidMap);
+            }
+            return OrmUtils_1.OrmUtils.mergeDeep(map, generatedColumn.createValueMap(value));
+        }, {});
+        return Object.keys(generatedMap).length > 0 ? generatedMap : undefined;
+    }
+    /**
+     * Differentiate columns of this table and columns from the given column metadatas columns
+     * and returns only changed.
+     *
+     * @param tableColumns
+     * @param columnMetadatas
+     */
+    findChangedColumns(tableColumns, columnMetadatas) {
+        return columnMetadatas.filter((columnMetadata) => {
+            const tableColumn = tableColumns.find((c) => c.name === columnMetadata.databaseName);
+            if (!tableColumn) {
+                // we don't need new columns, we only need exist and changed
+                return false;
+            }
+            const normalizedDefault = this.normalizeDefault(columnMetadata);
+            return (tableColumn.name !== columnMetadata.databaseName ||
+                tableColumn.type !== this.normalizeType(columnMetadata) ||
+                (columnMetadata.length &&
+                    tableColumn.length !==
+                        this.getColumnLength(columnMetadata)) ||
+                tableColumn.precision !== columnMetadata.precision ||
+                tableColumn.scale !== columnMetadata.scale ||
+                tableColumn.comment !==
+                    this.escapeComment(columnMetadata.comment) ||
+                (!tableColumn.isGenerated &&
+                    normalizedDefault !== tableColumn.default) || // we included check for generated here, because generated columns already can have default values
+                tableColumn.isPrimary !== columnMetadata.isPrimary ||
+                tableColumn.isNullable !== columnMetadata.isNullable ||
+                tableColumn.isUnique !==
+                    this.normalizeIsUnique(columnMetadata) ||
+                (columnMetadata.generationStrategy !== "uuid" &&
+                    tableColumn.isGenerated !== columnMetadata.isGenerated) ||
+                (tableColumn.asExpression ?? "").trim() !==
+                    (columnMetadata.asExpression ?? "").trim());
+        });
+    }
+    /**
+     * Returns true if driver supports RETURNING / OUTPUT statement.
+     */
+    isReturningSqlSupported() {
+        return false;
+    }
+    /**
+     * Returns true if driver supports uuid values generation on its own.
+     */
+    isUUIDGenerationSupported() {
+        return false;
+    }
+    /**
+     * Returns true if driver supports fulltext indices.
+     */
+    isFullTextColumnTypeSupported() {
+        return !DriverUtils_1.DriverUtils.isReleaseVersionOrGreater(this, "4.0");
+    }
+    /**
+     * Creates an escaped parameter.
+     *
+     * @param parameterName
+     * @param index
+     */
+    createParameter(parameterName, index) {
+        return "?";
+    }
+    // -------------------------------------------------------------------------
+    // Protected Methods
+    // -------------------------------------------------------------------------
+    /**
+     * If driver dependency is not given explicitly, then try to load it via "require".
+     */
+    loadDependencies() {
+        const client = this.options.driver;
+        if (client) {
+            this.client = client;
+            return;
+        }
+        try {
+            this.client = PlatformTools_1.PlatformTools.load("@sap/hana-client");
+            this.streamClient = PlatformTools_1.PlatformTools.load("@sap/hana-client/extension/Stream");
+        }
+        catch {
+            // todo: better error for browser env
+            throw new DriverPackageNotInstalledError_1.DriverPackageNotInstalledError("SAP Hana", "@sap/hana-client");
+        }
+    }
+    /**
+     * Escapes a given comment.
+     *
+     * @param comment
+     */
+    escapeComment(comment) {
+        if (!comment)
+            return comment;
+        comment = comment.replaceAll("\u0000", ""); // Null bytes aren't allowed in comments
+        return comment;
+    }
+}
+exports.SapDriver = SapDriver;
+//# sourceMappingURL=SapDriver.js.map