@sqlitecloud/drivers 0.0.50 → 0.0.56

package/lib/sqlitecloud.drivers.dev.js

@@ -26,7 +26,7 @@ return /******/ (() => { // webpackBootstrap
 /***/ (function(__unused_webpack_module, exports, __webpack_require__) {
 
 "use strict";
-eval("\n/**\n * connection-tls.ts - handles low level communication with sqlitecloud server via tls socket and binary protocol\n */\nvar __importDefault = (this && this.__importDefault) || function (mod) {\n    return (mod && mod.__esModule) ? mod : { \"default\": mod };\n};\nObject.defineProperty(exports, \"__esModule\", ({ value: true }));\nexports.SQLiteCloudTlsConnection = void 0;\nconst types_1 = __webpack_require__(/*! ./types */ \"./lib/drivers/types.js\");\nconst connection_1 = __webpack_require__(/*! ./connection */ \"./lib/drivers/connection.js\");\nconst protocol_1 = __webpack_require__(/*! ./protocol */ \"./lib/drivers/protocol.js\");\nconst utilities_1 = __webpack_require__(/*! ./utilities */ \"./lib/drivers/utilities.js\");\nconst protocol_2 = __webpack_require__(/*! ./protocol */ \"./lib/drivers/protocol.js\");\nconst net_1 = __importDefault(__webpack_require__(/*! net */ \"?83b6\"));\nconst tls_1 = __importDefault(__webpack_require__(/*! tls */ \"?4235\"));\n/**\n * Implementation of SQLiteCloudConnection that connects directly to the database via tls socket and raw, binary protocol.\n * Connects with plain socket with no encryption is the ?insecure=1 parameter is specified.\n * SQLiteCloud low-level connection, will do messaging, handle socket, authentication, etc.\n * A connection socket is established when the connection is created and closed when the connection is closed.\n * All operations are serialized by waiting for any pending operations to complete. Once a connection is closed,\n * it cannot be reopened and you must create a new connection.\n */\nclass SQLiteCloudTlsConnection extends connection_1.SQLiteCloudConnection {\n    /** True if connection is open */\n    get connected() {\n        return !!this.socket;\n    }\n    /* Opens a connection with the server and sends the initialization commands. Will throw in case of errors. */\n    connectTransport(config, callback) {\n        // connection established while we were waiting in line?\n        console.assert(!this.connected, 'Connection already established');\n        // clear all listeners and call done in the operations queue\n        const finish = error => {\n            if (this.socket) {\n                this.socket.removeAllListeners('data');\n                this.socket.removeAllListeners('error');\n                this.socket.removeAllListeners('close');\n                if (error) {\n                    this.close();\n                }\n            }\n            callback === null || callback === void 0 ? void 0 : callback.call(this, error);\n        };\n        this.config = config;\n        const initializationCommands = (0, utilities_1.getInitializationCommands)(config);\n        if (config.insecure) {\n            // connect to plain socket, without encryption, only if insecure parameter specified\n            // this option is mainly for testing purposes and is not available on production nodes\n            // which would need to connect using tls and proper certificates as per code below\n            const connectionOptions = {\n                host: config.host,\n                port: config.port\n            };\n            this.socket = net_1.default.connect(connectionOptions, () => {\n                console.warn(`TlsConnection.connectTransport - connected to ${config.host}:${config.port} using insecure protocol`);\n                // send initialization commands\n                console.assert(this.socket, 'Connection already closed');\n                this.transportCommands(initializationCommands, error => {\n                    if (error && this.socket) {\n                        this.close();\n                    }\n                    if (callback) {\n                        callback === null || callback === void 0 ? void 0 : callback.call(this, error);\n                        callback = undefined;\n                    }\n                    finish(error);\n                });\n            });\n        }\n        else {\n            // connect to tls socket, initialize connection, setup event handlers\n            this.socket = tls_1.default.connect(this.config.port, this.config.host, this.config.tlsOptions, () => {\n                const tlsSocket = this.socket;\n                if (!(tlsSocket === null || tlsSocket === void 0 ? void 0 : tlsSocket.authorized)) {\n                    const anonimizedError = (0, utilities_1.anonimizeError)(tlsSocket.authorizationError);\n                    console.error('Connection was not authorized', anonimizedError);\n                    this.close();\n                    finish(new types_1.SQLiteCloudError('Connection was not authorized', { cause: anonimizedError }));\n                }\n                else {\n                    // the connection was closed before it was even opened,\n                    // eg. client closed the connection before the server accepted it\n                    if (this.socket === null) {\n                        finish(new types_1.SQLiteCloudError('Connection was closed before it was done opening'));\n                        return;\n                    }\n                    // send initialization commands\n                    console.assert(this.socket, 'Connection already closed');\n                    this.transportCommands(initializationCommands, error => {\n                        if (error && this.socket) {\n                            this.close();\n                        }\n                        if (callback) {\n                            callback === null || callback === void 0 ? void 0 : callback.call(this, error);\n                            callback = undefined;\n                        }\n                        finish(error);\n                    });\n                }\n            });\n        }\n        this.socket.on('close', () => {\n            this.socket = null;\n            finish(new types_1.SQLiteCloudError('Connection was closed'));\n        });\n        this.socket.once('error', (error) => {\n            console.error('Connection error', error);\n            finish(new types_1.SQLiteCloudError('Connection error', { cause: error }));\n        });\n        return this;\n    }\n    /** Will send a command immediately (no queueing), return the rowset/result or throw an error */\n    transportCommands(commands, callback) {\n        var _a, _b, _c;\n        // connection needs to be established?\n        if (!this.socket) {\n            callback === null || callback === void 0 ? void 0 : callback.call(this, new types_1.SQLiteCloudError('Connection not established', { errorCode: 'ERR_CONNECTION_NOT_ESTABLISHED' }));\n            return this;\n        }\n        // compose commands following SCPC protocol\n        commands = (0, protocol_1.formatCommand)(commands);\n        let buffer = Buffer.alloc(0);\n        const rowsetChunks = [];\n        // const startedOn = new Date()\n        // define what to do if an answer does not arrive within the set timeout\n        let socketTimeout;\n        // clear all listeners and call done in the operations queue\n        const finish = (error, result) => {\n            clearTimeout(socketTimeout);\n            if (this.socket) {\n                this.socket.removeAllListeners('data');\n                this.socket.removeAllListeners('error');\n                this.socket.removeAllListeners('close');\n            }\n            if (callback) {\n                callback === null || callback === void 0 ? void 0 : callback.call(this, error, result);\n                callback = undefined;\n            }\n        };\n        // define the Promise that waits for the server response\n        const readData = (data) => {\n            var _a, _b;\n            try {\n                // on first ondata event, dataType is read from data, on subsequent ondata event, is read from buffer that is the concatanations of data received on each ondata event\n                let dataType = buffer.length === 0 ? data.subarray(0, 1).toString() : buffer.subarray(0, 1).toString('utf8');\n                buffer = Buffer.concat([buffer, data]);\n                const commandLength = (0, protocol_1.hasCommandLength)(dataType);\n                if (commandLength) {\n                    const commandLength = (0, protocol_1.parseCommandLength)(buffer);\n                    const hasReceivedEntireCommand = buffer.length - buffer.indexOf(' ') - 1 >= commandLength ? true : false;\n                    if (hasReceivedEntireCommand) {\n                        if ((_a = this.config) === null || _a === void 0 ? void 0 : _a.verbose) {\n                            let bufferString = buffer.toString('utf8');\n                            if (bufferString.length > 1000) {\n                                bufferString = bufferString.substring(0, 100) + '...' + bufferString.substring(bufferString.length - 40);\n                            }\n                            // const elapsedMs = new Date().getTime() - startedOn.getTime()\n                            // console.debug(`Receive: ${bufferString} - ${elapsedMs}ms`)\n                        }\n                        // need to decompress this buffer before decoding?\n                        if (dataType === protocol_1.CMD_COMPRESSED) {\n                            ;\n                            ({ buffer, dataType } = (0, protocol_1.decompressBuffer)(buffer));\n                        }\n                        if (dataType !== protocol_1.CMD_ROWSET_CHUNK) {\n                            (_b = this.socket) === null || _b === void 0 ? void 0 : _b.off('data', readData);\n                            const { data } = (0, protocol_1.popData)(buffer);\n                            finish(null, data);\n                        }\n                        else {\n                            // check if rowset received the ending chunk\n                            if ((0, protocol_1.bufferEndsWith)(buffer, protocol_1.ROWSET_CHUNKS_END)) {\n                                rowsetChunks.push(buffer);\n                                const parsedData = (0, protocol_2.parseRowsetChunks)(rowsetChunks);\n                                finish === null || finish === void 0 ? void 0 : finish.call(this, null, parsedData);\n                            }\n                            else {\n                                // no ending string? ask server for another chunk\n                                rowsetChunks.push(buffer);\n                                buffer = Buffer.alloc(0);\n                            }\n                        }\n                    }\n                }\n                else {\n                    // command with no explicit len so make sure that the final character is a space\n                    const lastChar = buffer.subarray(buffer.length - 1, buffer.length).toString('utf8');\n                    if (lastChar == ' ') {\n                        const { data } = (0, protocol_1.popData)(buffer);\n                        finish(null, data);\n                    }\n                }\n            }\n            catch (error) {\n                console.assert(error instanceof Error);\n                if (error instanceof Error) {\n                    finish(error);\n                }\n            }\n        };\n        (_a = this.socket) === null || _a === void 0 ? void 0 : _a.once('close', () => {\n            finish(new types_1.SQLiteCloudError('Connection was closed', { cause: (0, utilities_1.anonimizeCommand)(commands) }));\n        });\n        (_b = this.socket) === null || _b === void 0 ? void 0 : _b.write(commands, 'utf8', () => {\n            var _a, _b;\n            // @ts-ignore\n            socketTimeout = setTimeout(() => {\n                const timeoutError = new types_1.SQLiteCloudError('Request timed out', { cause: (0, utilities_1.anonimizeCommand)(commands) });\n                // console.debug(`Request timed out, config.timeout is ${this.config?.timeout as number}ms`, timeoutError)\n                finish(timeoutError);\n            }, (_a = this.config) === null || _a === void 0 ? void 0 : _a.timeout);\n            (_b = this.socket) === null || _b === void 0 ? void 0 : _b.on('data', readData);\n        });\n        (_c = this.socket) === null || _c === void 0 ? void 0 : _c.once('error', (error) => {\n            console.error('Socket error', error);\n            this.close();\n            finish(new types_1.SQLiteCloudError('Socket error', { cause: (0, utilities_1.anonimizeError)(error) }));\n        });\n        return this;\n    }\n    /** Disconnect from server, release connection. */\n    close() {\n        console.assert(this.socket !== null, 'TlsConnection.close - connection already closed');\n        this.operations.clear();\n        if (this.socket) {\n            this.socket.destroy();\n            this.socket = null;\n        }\n        this.socket = undefined;\n        return this;\n    }\n}\nexports.SQLiteCloudTlsConnection = SQLiteCloudTlsConnection;\nexports[\"default\"] = SQLiteCloudTlsConnection;\n\n\n//# sourceURL=webpack://sqlitecloud/./lib/drivers/connection-tls.js?");
+eval("\n/**\n * connection-tls.ts - connection via tls socket and sqlitecloud protocol\n */\nvar __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {\n    if (k2 === undefined) k2 = k;\n    var desc = Object.getOwnPropertyDescriptor(m, k);\n    if (!desc || (\"get\" in desc ? !m.__esModule : desc.writable || desc.configurable)) {\n      desc = { enumerable: true, get: function() { return m[k]; } };\n    }\n    Object.defineProperty(o, k2, desc);\n}) : (function(o, m, k, k2) {\n    if (k2 === undefined) k2 = k;\n    o[k2] = m[k];\n}));\nvar __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {\n    Object.defineProperty(o, \"default\", { enumerable: true, value: v });\n}) : function(o, v) {\n    o[\"default\"] = v;\n});\nvar __importStar = (this && this.__importStar) || function (mod) {\n    if (mod && mod.__esModule) return mod;\n    var result = {};\n    if (mod != null) for (var k in mod) if (k !== \"default\" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);\n    __setModuleDefault(result, mod);\n    return result;\n};\nObject.defineProperty(exports, \"__esModule\", ({ value: true }));\nexports.SQLiteCloudTlsConnection = void 0;\nconst types_1 = __webpack_require__(/*! ./types */ \"./lib/drivers/types.js\");\nconst connection_1 = __webpack_require__(/*! ./connection */ \"./lib/drivers/connection.js\");\nconst utilities_1 = __webpack_require__(/*! ./utilities */ \"./lib/drivers/utilities.js\");\nconst protocol_1 = __webpack_require__(/*! ./protocol */ \"./lib/drivers/protocol.js\");\nconst tls = __importStar(__webpack_require__(/*! tls */ \"?4235\"));\n/**\n * Implementation of SQLiteCloudConnection that connects to the database using specific Bun APIs\n * that connect to native sockets or tls sockets and communicates via raw, binary protocol.\n */\nclass SQLiteCloudTlsConnection extends connection_1.SQLiteCloudConnection {\n    constructor() {\n        super(...arguments);\n        // processCommands sets up empty buffers, results callback then send the command to the server via socket.write\n        // onData is called when data is received, it will process the data until all data is retrieved for a response\n        // when response is complete or there's an error, finish is called to call the results callback set by processCommands...\n        // buffer to accumulate incoming data until an whole command is received and can be parsed\n        this.buffer = Buffer.alloc(0);\n        this.startedOn = new Date();\n    }\n    /** True if connection is open */\n    get connected() {\n        return !!this.socket;\n    }\n    /* Opens a connection with the server and sends the initialization commands. Will throw in case of errors. */\n    /* eslint-disable @typescript-eslint/no-unused-vars */\n    connectTransport(config, callback) {\n        console.assert(!this.connected, 'SQLiteCloudTlsConnection.connect - connection already established');\n        if (this.config.verbose) {\n            console.debug(`-> connecting ${config === null || config === void 0 ? void 0 : config.host}:${config === null || config === void 0 ? void 0 : config.port}`);\n        }\n        this.config = config;\n        const initializationCommands = (0, utilities_1.getInitializationCommands)(config);\n        // connect to plain socket, without encryption, only if insecure parameter specified\n        // this option is mainly for testing purposes and is not available on production nodes\n        // which would need to connect using tls and proper certificates as per code below\n        const connectionOptions = {\n            host: config.host,\n            port: config.port,\n            rejectUnauthorized: false,\n            // Server name for the SNI (Server Name Indication) TLS extension.\n            // https://r2.nodejs.org/docs/v6.11.4/api/tls.html#tls_class_tls_tlssocket\n            servername: config.host\n        };\n        this.socket = tls.connect(connectionOptions, () => {\n            var _a;\n            if (this.config.verbose) {\n                console.debug(`SQLiteCloudTlsConnection - connected to ${this.config.host}, authorized: ${(_a = this.socket) === null || _a === void 0 ? void 0 : _a.authorized}`);\n            }\n            this.transportCommands(initializationCommands, error => {\n                if (this.config.verbose) {\n                    console.debug(`SQLiteCloudTlsConnection - initialized connection`);\n                }\n                callback === null || callback === void 0 ? void 0 : callback.call(this, error);\n            });\n        });\n        this.socket.on('data', data => {\n            this.processCommandsData(data);\n        });\n        this.socket.on('error', error => {\n            this.close();\n            this.processCommandsFinish(new types_1.SQLiteCloudError('Connection error', { errorCode: 'ERR_CONNECTION_ERROR', cause: error }));\n        });\n        this.socket.on('end', () => {\n            this.close();\n            if (this.processCallback)\n                this.processCommandsFinish(new types_1.SQLiteCloudError('Server ended the connection', { errorCode: 'ERR_CONNECTION_ENDED' }));\n        });\n        this.socket.on('close', () => {\n            this.close();\n            this.processCommandsFinish(new types_1.SQLiteCloudError('Connection closed', { errorCode: 'ERR_CONNECTION_CLOSED' }));\n        });\n        return this;\n    }\n    /** Will send a command immediately (no queueing), return the rowset/result or throw an error */\n    transportCommands(commands, callback) {\n        var _a, _b, _c, _d, _e;\n        // connection needs to be established?\n        if (!this.socket) {\n            callback === null || callback === void 0 ? void 0 : callback.call(this, new types_1.SQLiteCloudError('Connection not established', { errorCode: 'ERR_CONNECTION_NOT_ESTABLISHED' }));\n            return this;\n        }\n        // reset buffer and rowset chunks, define response callback\n        this.buffer = Buffer.alloc(0);\n        this.startedOn = new Date();\n        this.processCallback = callback;\n        this.executingCommands = commands;\n        // compose commands following SCPC protocol\n        const formattedCommands = (0, protocol_1.formatCommand)(commands);\n        if ((_a = this.config) === null || _a === void 0 ? void 0 : _a.verbose) {\n            console.debug(`-> ${formattedCommands}`);\n        }\n        const timeoutMs = (_c = (_b = this.config) === null || _b === void 0 ? void 0 : _b.timeout) !== null && _c !== void 0 ? _c : 0;\n        if (timeoutMs > 0) {\n            const timeout = setTimeout(() => {\n                var _a;\n                callback === null || callback === void 0 ? void 0 : callback.call(this, new types_1.SQLiteCloudError('Connection timeout out', { errorCode: 'ERR_CONNECTION_TIMEOUT' }));\n                (_a = this.socket) === null || _a === void 0 ? void 0 : _a.destroy();\n                this.socket = undefined;\n            }, timeoutMs);\n            (_d = this.socket) === null || _d === void 0 ? void 0 : _d.write(formattedCommands, 'utf-8', () => {\n                clearTimeout(timeout); // Clear the timeout on successful write\n            });\n        }\n        else {\n            (_e = this.socket) === null || _e === void 0 ? void 0 : _e.write(formattedCommands, 'utf-8');\n        }\n        return this;\n    }\n    /** Handles data received in response to an outbound command sent by processCommands */\n    processCommandsData(data) {\n        var _a, _b, _c, _d, _e, _f;\n        try {\n            // append data to buffer as it arrives\n            if (data.length && data.length > 0) {\n                this.buffer = Buffer.concat([this.buffer, data]);\n            }\n            let dataType = (_a = this.buffer) === null || _a === void 0 ? void 0 : _a.subarray(0, 1).toString();\n            if ((0, protocol_1.hasCommandLength)(dataType)) {\n                const commandLength = (0, protocol_1.parseCommandLength)(this.buffer);\n                const hasReceivedEntireCommand = this.buffer.length - this.buffer.indexOf(' ') - 1 >= commandLength ? true : false;\n                if (hasReceivedEntireCommand) {\n                    if ((_b = this.config) === null || _b === void 0 ? void 0 : _b.verbose) {\n                        let bufferString = this.buffer.toString('utf8');\n                        if (bufferString.length > 1000) {\n                            bufferString = bufferString.substring(0, 100) + '...' + bufferString.substring(bufferString.length - 40);\n                        }\n                        const elapsedMs = new Date().getTime() - this.startedOn.getTime();\n                        console.debug(`<- ${bufferString} (${elapsedMs}ms)`);\n                    }\n                    // need to decompress this buffer before decoding?\n                    if (dataType === protocol_1.CMD_COMPRESSED) {\n                        ;\n                        ({ buffer: this.buffer, dataType } = (0, protocol_1.decompressBuffer)(this.buffer));\n                    }\n                    if (dataType !== protocol_1.CMD_ROWSET_CHUNK) {\n                        const { data } = (0, protocol_1.popData)(this.buffer);\n                        (_c = this.processCommandsFinish) === null || _c === void 0 ? void 0 : _c.call(this, null, data);\n                    }\n                    else {\n                        // check if rowset received the ending chunk in which case it can be unpacked\n                        if ((0, protocol_1.bufferEndsWith)(this.buffer, protocol_1.ROWSET_CHUNKS_END)) {\n                            const parsedData = (0, protocol_1.parseRowsetChunks)([this.buffer]);\n                            (_d = this.processCommandsFinish) === null || _d === void 0 ? void 0 : _d.call(this, null, parsedData);\n                        }\n                    }\n                }\n            }\n            else {\n                // command with no explicit len so make sure that the final character is a space\n                const lastChar = this.buffer.subarray(this.buffer.length - 1, this.buffer.length).toString('utf8');\n                if (lastChar == ' ') {\n                    const { data } = (0, protocol_1.popData)(this.buffer);\n                    (_e = this.processCommandsFinish) === null || _e === void 0 ? void 0 : _e.call(this, null, data);\n                }\n            }\n        }\n        catch (error) {\n            console.assert(error instanceof Error);\n            if (error instanceof Error) {\n                (_f = this.processCommandsFinish) === null || _f === void 0 ? void 0 : _f.call(this, error);\n            }\n        }\n    }\n    /** Completes a transaction initiated by processCommands */\n    processCommandsFinish(error, result) {\n        if (error) {\n            if (this.processCallback) {\n                console.error('processCommandsFinish - error', error);\n            }\n            else {\n                console.warn('processCommandsFinish - error with no registered callback', error);\n            }\n        }\n        if (this.processCallback) {\n            this.processCallback(error, result);\n            //      this.processCallback = undefined\n        }\n    }\n    /** Disconnect immediately, release connection, no events. */\n    close() {\n        if (this.socket) {\n            this.socket.removeAllListeners();\n            this.socket.destroy();\n            this.socket = undefined;\n        }\n        this.operations.clear();\n        return this;\n    }\n}\nexports.SQLiteCloudTlsConnection = SQLiteCloudTlsConnection;\nexports[\"default\"] = SQLiteCloudTlsConnection;\n\n\n//# sourceURL=webpack://sqlitecloud/./lib/drivers/connection-tls.js?");
 
 /***/ }),
 
@@ -37,7 +37,7 @@ eval("\n/**\n * connection-tls.ts - handles low level communication with sqlitec
 /***/ ((__unused_webpack_module, exports, __webpack_require__) => {
 
 "use strict";
-eval("\n/**\n * transport-ws.ts - handles low level communication with sqlitecloud server via socket.io websocket\n */\nObject.defineProperty(exports, \"__esModule\", ({ value: true }));\nexports.SQLiteCloudWebsocketConnection = void 0;\nconst types_1 = __webpack_require__(/*! ./types */ \"./lib/drivers/types.js\");\nconst rowset_1 = __webpack_require__(/*! ./rowset */ \"./lib/drivers/rowset.js\");\nconst connection_1 = __webpack_require__(/*! ./connection */ \"./lib/drivers/connection.js\");\nconst socket_io_client_1 = __webpack_require__(/*! socket.io-client */ \"./node_modules/socket.io-client/build/cjs/index.js\");\n/**\n * Implementation of TransportConnection that connects to the database indirectly\n * via SQLite Cloud Gateway, a socket.io based deamon that responds to sql query\n * requests by returning results and rowsets in json format. The gateway handles\n * connect, disconnect, retries, order of operations, timeouts, etc.\n */\nclass SQLiteCloudWebsocketConnection extends connection_1.SQLiteCloudConnection {\n    /** True if connection is open */\n    get connected() {\n        return !!this.socket;\n    }\n    /* Opens a connection with the server and sends the initialization commands. Will throw in case of errors. */\n    connectTransport(config, callback) {\n        var _a;\n        try {\n            // connection established while we were waiting in line?\n            console.assert(!this.connected, 'Connection already established');\n            if (!this.socket) {\n                this.config = config;\n                const connectionString = this.config.connectionString;\n                const gatewayUrl = ((_a = this.config) === null || _a === void 0 ? void 0 : _a.gatewayUrl) || `ws://${this.config.host}:4000`;\n                this.socket = (0, socket_io_client_1.io)(gatewayUrl, { auth: { token: connectionString } });\n            }\n            callback === null || callback === void 0 ? void 0 : callback.call(this, null);\n        }\n        catch (error) {\n            callback === null || callback === void 0 ? void 0 : callback.call(this, error);\n        }\n        return this;\n    }\n    /** Will send a command immediately (no queueing), return the rowset/result or throw an error */\n    transportCommands(commands, callback) {\n        // connection needs to be established?\n        if (!this.socket) {\n            callback === null || callback === void 0 ? void 0 : callback.call(this, new types_1.SQLiteCloudError('Connection not established', { errorCode: 'ERR_CONNECTION_NOT_ESTABLISHED' }));\n            return this;\n        }\n        this.socket.emit('v1/sql', { sql: commands, row: 'array' }, (response) => {\n            if (response === null || response === void 0 ? void 0 : response.error) {\n                const error = new types_1.SQLiteCloudError(response.error.detail, Object.assign({}, response.error));\n                callback === null || callback === void 0 ? void 0 : callback.call(this, error);\n            }\n            else {\n                const { data, metadata } = response;\n                if (data && metadata) {\n                    if (metadata.numberOfRows !== undefined && metadata.numberOfColumns !== undefined && metadata.columns !== undefined) {\n                        console.assert(Array.isArray(data), 'SQLiteCloudWebsocketConnection.transportCommands - data is not an array');\n                        // we can recreate a SQLiteCloudRowset from the response which we know to be an array of arrays\n                        // eslint-disable-next-line @typescript-eslint/no-unsafe-call\n                        const rowset = new rowset_1.SQLiteCloudRowset(metadata, data.flat());\n                        callback === null || callback === void 0 ? void 0 : callback.call(this, null, rowset);\n                        return;\n                    }\n                }\n                callback === null || callback === void 0 ? void 0 : callback.call(this, null, response === null || response === void 0 ? void 0 : response.data);\n            }\n        });\n        return this;\n    }\n    /** Disconnect socket.io from server */\n    close() {\n        var _a;\n        console.assert(this.socket !== null, 'SQLiteCloudWebsocketConnection.close - connection already closed');\n        if (this.socket) {\n            (_a = this.socket) === null || _a === void 0 ? void 0 : _a.close();\n            this.socket = undefined;\n        }\n        this.operations.clear();\n        this.socket = undefined;\n        return this;\n    }\n}\nexports.SQLiteCloudWebsocketConnection = SQLiteCloudWebsocketConnection;\nexports[\"default\"] = SQLiteCloudWebsocketConnection;\n\n\n//# sourceURL=webpack://sqlitecloud/./lib/drivers/connection-ws.js?");
+eval("\n/**\n * transport-ws.ts - handles low level communication with sqlitecloud server via socket.io websocket\n */\nObject.defineProperty(exports, \"__esModule\", ({ value: true }));\nexports.SQLiteCloudWebsocketConnection = void 0;\nconst types_1 = __webpack_require__(/*! ./types */ \"./lib/drivers/types.js\");\nconst rowset_1 = __webpack_require__(/*! ./rowset */ \"./lib/drivers/rowset.js\");\nconst connection_1 = __webpack_require__(/*! ./connection */ \"./lib/drivers/connection.js\");\nconst socket_io_client_1 = __webpack_require__(/*! socket.io-client */ \"./node_modules/socket.io-client/build/cjs/index.js\");\n/**\n * Implementation of TransportConnection that connects to the database indirectly\n * via SQLite Cloud Gateway, a socket.io based deamon that responds to sql query\n * requests by returning results and rowsets in json format. The gateway handles\n * connect, disconnect, retries, order of operations, timeouts, etc.\n */\nclass SQLiteCloudWebsocketConnection extends connection_1.SQLiteCloudConnection {\n    /** True if connection is open */\n    get connected() {\n        return !!this.socket;\n    }\n    /* Opens a connection with the server and sends the initialization commands. Will throw in case of errors. */\n    connectTransport(config, callback) {\n        var _a;\n        try {\n            // connection established while we were waiting in line?\n            console.assert(!this.connected, 'Connection already established');\n            if (!this.socket) {\n                this.config = config;\n                const connectionString = this.config.connectionString;\n                const gatewayUrl = ((_a = this.config) === null || _a === void 0 ? void 0 : _a.gatewayUrl) || `${this.config.host === 'localhost' ? 'ws' : 'wss'}://${this.config.host}:4000`;\n                this.socket = (0, socket_io_client_1.io)(gatewayUrl, { auth: { token: connectionString } });\n            }\n            callback === null || callback === void 0 ? void 0 : callback.call(this, null);\n        }\n        catch (error) {\n            callback === null || callback === void 0 ? void 0 : callback.call(this, error);\n        }\n        return this;\n    }\n    /** Will send a command immediately (no queueing), return the rowset/result or throw an error */\n    transportCommands(commands, callback) {\n        // connection needs to be established?\n        if (!this.socket) {\n            callback === null || callback === void 0 ? void 0 : callback.call(this, new types_1.SQLiteCloudError('Connection not established', { errorCode: 'ERR_CONNECTION_NOT_ESTABLISHED' }));\n            return this;\n        }\n        this.socket.emit('v1/sql', { sql: commands, row: 'array' }, (response) => {\n            if (response === null || response === void 0 ? void 0 : response.error) {\n                const error = new types_1.SQLiteCloudError(response.error.detail, Object.assign({}, response.error));\n                callback === null || callback === void 0 ? void 0 : callback.call(this, error);\n            }\n            else {\n                const { data, metadata } = response;\n                if (data && metadata) {\n                    if (metadata.numberOfRows !== undefined && metadata.numberOfColumns !== undefined && metadata.columns !== undefined) {\n                        console.assert(Array.isArray(data), 'SQLiteCloudWebsocketConnection.transportCommands - data is not an array');\n                        // we can recreate a SQLiteCloudRowset from the response which we know to be an array of arrays\n                        // eslint-disable-next-line @typescript-eslint/no-unsafe-call\n                        const rowset = new rowset_1.SQLiteCloudRowset(metadata, data.flat());\n                        callback === null || callback === void 0 ? void 0 : callback.call(this, null, rowset);\n                        return;\n                    }\n                }\n                callback === null || callback === void 0 ? void 0 : callback.call(this, null, response === null || response === void 0 ? void 0 : response.data);\n            }\n        });\n        return this;\n    }\n    /** Disconnect socket.io from server */\n    close() {\n        var _a;\n        console.assert(this.socket !== null, 'SQLiteCloudWebsocketConnection.close - connection already closed');\n        if (this.socket) {\n            (_a = this.socket) === null || _a === void 0 ? void 0 : _a.close();\n            this.socket = undefined;\n        }\n        this.operations.clear();\n        this.socket = undefined;\n        return this;\n    }\n}\nexports.SQLiteCloudWebsocketConnection = SQLiteCloudWebsocketConnection;\nexports[\"default\"] = SQLiteCloudWebsocketConnection;\n\n\n//# sourceURL=webpack://sqlitecloud/./lib/drivers/connection-ws.js?");
 
 /***/ }),
 
@@ -48,7 +48,7 @@ eval("\n/**\n * transport-ws.ts - handles low level communication with sqliteclo
 /***/ ((__unused_webpack_module, exports, __webpack_require__) => {
 
 "use strict";
-eval("\n/**\n * connection.ts - base abstract class for sqlitecloud server connections\n */\nObject.defineProperty(exports, \"__esModule\", ({ value: true }));\nexports.SQLiteCloudConnection = void 0;\nconst types_1 = __webpack_require__(/*! ./types */ \"./lib/drivers/types.js\");\nconst utilities_1 = __webpack_require__(/*! ./utilities */ \"./lib/drivers/utilities.js\");\nconst queue_1 = __webpack_require__(/*! ./queue */ \"./lib/drivers/queue.js\");\nconst utilities_2 = __webpack_require__(/*! ./utilities */ \"./lib/drivers/utilities.js\");\n/**\n * Base class for SQLiteCloudConnection handles basics and defines methods.\n * Actual connection management and communication with the server in concrete classes.\n */\nclass SQLiteCloudConnection {\n    /** Parse and validate provided connectionString or configuration */\n    constructor(config, callback) {\n        /** Operations are serialized by waiting an any pending promises */\n        this.operations = new queue_1.OperationsQueue();\n        if (typeof config === 'string') {\n            this.config = (0, utilities_1.validateConfiguration)({ connectionString: config });\n        }\n        else {\n            this.config = (0, utilities_1.validateConfiguration)(config);\n        }\n        // connect transport layer to server\n        this.connect(callback);\n    }\n    //\n    // internal methods (some are implemented in concrete classes using different transport layers)\n    //\n    /** Connect will establish a tls or websocket transport to the server based on configuration and environment */\n    connect(callback) {\n        this.operations.enqueue(done => {\n            this.connectTransport(this.config, error => {\n                if (error) {\n                    console.error(`SQLiteCloudConnection.connect - error connecting ${this.config.host}:${this.config.port} ${error.toString()}`, error);\n                    this.close();\n                }\n                callback === null || callback === void 0 ? void 0 : callback.call(this, error || null);\n                done(error);\n            });\n        });\n        return this;\n    }\n    /** Will log to console if verbose mode is enabled */\n    log(message, ...optionalParams) {\n        if (this.config.verbose) {\n            message = (0, utilities_2.anonimizeCommand)(message);\n            console.log(`${new Date().toISOString()} ${this.config.clientId}: ${message}`, ...optionalParams);\n        }\n    }\n    /** Enable verbose logging for debug purposes */\n    verbose() {\n        this.config.verbose = true;\n    }\n    /** Will enquee a command to be executed and callback with the resulting rowset/result/error */\n    sendCommands(commands, callback) {\n        this.operations.enqueue(done => {\n            if (!this.connected) {\n                const error = new types_1.SQLiteCloudError('Connection not established', { errorCode: 'ERR_CONNECTION_NOT_ESTABLISHED' });\n                callback === null || callback === void 0 ? void 0 : callback.call(this, error);\n                done(error);\n            }\n            this.transportCommands(commands, (error, result) => {\n                callback === null || callback === void 0 ? void 0 : callback.call(this, error, result);\n                done(error);\n            });\n        });\n        return this;\n    }\n}\nexports.SQLiteCloudConnection = SQLiteCloudConnection;\n\n\n//# sourceURL=webpack://sqlitecloud/./lib/drivers/connection.js?");
+eval("\n/**\n * connection.ts - base abstract class for sqlitecloud server connections\n */\nObject.defineProperty(exports, \"__esModule\", ({ value: true }));\nexports.SQLiteCloudConnection = void 0;\nconst types_1 = __webpack_require__(/*! ./types */ \"./lib/drivers/types.js\");\nconst utilities_1 = __webpack_require__(/*! ./utilities */ \"./lib/drivers/utilities.js\");\nconst queue_1 = __webpack_require__(/*! ./queue */ \"./lib/drivers/queue.js\");\nconst utilities_2 = __webpack_require__(/*! ./utilities */ \"./lib/drivers/utilities.js\");\n/**\n * Base class for SQLiteCloudConnection handles basics and defines methods.\n * Actual connection management and communication with the server in concrete classes.\n */\nclass SQLiteCloudConnection {\n    /** Parse and validate provided connectionString or configuration */\n    constructor(config, callback) {\n        /** Operations are serialized by waiting an any pending promises */\n        this.operations = new queue_1.OperationsQueue();\n        if (typeof config === 'string') {\n            this.config = (0, utilities_1.validateConfiguration)({ connectionString: config });\n        }\n        else {\n            this.config = (0, utilities_1.validateConfiguration)(config);\n        }\n        // connect transport layer to server\n        this.connect(callback);\n    }\n    /** Returns the connection's configuration */\n    getConfig() {\n        return Object.assign({}, this.config);\n    }\n    //\n    // internal methods (some are implemented in concrete classes using different transport layers)\n    //\n    /** Connect will establish a tls or websocket transport to the server based on configuration and environment */\n    connect(callback) {\n        this.operations.enqueue(done => {\n            this.connectTransport(this.config, error => {\n                if (error) {\n                    console.error(`SQLiteCloudConnection.connect - error connecting ${this.config.host}:${this.config.port} ${error.toString()}`, error);\n                    this.close();\n                }\n                if (callback) {\n                    callback.call(this, error || null);\n                }\n                done(error);\n            });\n        });\n        return this;\n    }\n    /** Will log to console if verbose mode is enabled */\n    log(message, ...optionalParams) {\n        if (this.config.verbose) {\n            message = (0, utilities_2.anonimizeCommand)(message);\n            console.log(`${new Date().toISOString()} ${this.config.clientId}: ${message}`, ...optionalParams);\n        }\n    }\n    /** Enable verbose logging for debug purposes */\n    verbose() {\n        this.config.verbose = true;\n    }\n    /** Will enquee a command to be executed and callback with the resulting rowset/result/error */\n    sendCommands(commands, callback) {\n        this.operations.enqueue(done => {\n            if (!this.connected) {\n                const error = new types_1.SQLiteCloudError('Connection not established', { errorCode: 'ERR_CONNECTION_NOT_ESTABLISHED' });\n                callback === null || callback === void 0 ? void 0 : callback.call(this, error);\n                done(error);\n            }\n            else {\n                this.transportCommands(commands, (error, result) => {\n                    callback === null || callback === void 0 ? void 0 : callback.call(this, error, result);\n                    done(error);\n                });\n            }\n        });\n        return this;\n    }\n}\nexports.SQLiteCloudConnection = SQLiteCloudConnection;\n\n\n//# sourceURL=webpack://sqlitecloud/./lib/drivers/connection.js?");
 
 /***/ }),
 
@@ -125,7 +125,7 @@ eval("\n/**\n * types.ts - shared types and interfaces\n */\nObject.defineProper
 /***/ ((__unused_webpack_module, exports, __webpack_require__) => {
 
 "use strict";
-eval("\n//\n// utilities.ts - utility methods to manipulate SQL statements\n//\nObject.defineProperty(exports, \"__esModule\", ({ value: true }));\nexports.parseBoolean = exports.parseConnectionString = exports.validateConfiguration = exports.popCallback = exports.prepareSql = exports.escapeSqlParameter = exports.getInitializationCommands = exports.anonimizeError = exports.anonimizeCommand = exports.isNode = exports.isBrowser = void 0;\nconst types_1 = __webpack_require__(/*! ./types */ \"./lib/drivers/types.js\");\n//\n// determining running environment, thanks to browser-or-node\n// https://www.npmjs.com/package/browser-or-node\n//\nexports.isBrowser = typeof window !== 'undefined' && typeof window.document !== 'undefined';\nexports.isNode = typeof process !== 'undefined' && process.versions != null && process.versions.node != null;\n//\n// utility methods\n//\n/** Messages going to the server are sometimes logged when error conditions occour and need to be stripped of user credentials  */\nfunction anonimizeCommand(message) {\n    // hide password in AUTH command if needed\n    message = message.replace(/USER \\S+/, 'USER ******');\n    message = message.replace(/PASSWORD \\S+?(?=;)/, 'PASSWORD ******');\n    message = message.replace(/HASH \\S+?(?=;)/, 'HASH ******');\n    return message;\n}\nexports.anonimizeCommand = anonimizeCommand;\n/** Strip message code in error of user credentials */\nfunction anonimizeError(error) {\n    if (error === null || error === void 0 ? void 0 : error.message) {\n        error.message = anonimizeCommand(error.message);\n    }\n    return error;\n}\nexports.anonimizeError = anonimizeError;\n/** Initialization commands sent to database when connection is established */\nfunction getInitializationCommands(config) {\n    // first user authentication, then all other commands\n    let commands = `AUTH USER ${config.username || ''} ${config.passwordHashed ? 'HASH' : 'PASSWORD'} ${config.password || ''}; `;\n    if (config.database) {\n        if (config.createDatabase && !config.dbMemory) {\n            commands += `CREATE DATABASE ${config.database} IF NOT EXISTS; `;\n        }\n        commands += `USE DATABASE ${config.database}; `;\n    }\n    if (config.compression) {\n        commands += 'SET CLIENT KEY COMPRESSION TO 1; ';\n    }\n    if (config.nonlinearizable) {\n        commands += 'SET CLIENT KEY NONLINEARIZABLE TO 1; ';\n    }\n    if (config.noBlob) {\n        commands += 'SET CLIENT KEY NOBLOB TO 1; ';\n    }\n    if (config.maxData) {\n        commands += `SET CLIENT KEY MAXDATA TO ${config.maxData}; `;\n    }\n    if (config.maxRows) {\n        commands += `SET CLIENT KEY MAXROWS TO ${config.maxRows}; `;\n    }\n    if (config.maxRowset) {\n        commands += `SET CLIENT KEY MAXROWSET TO ${config.maxRowset}; `;\n    }\n    return commands;\n}\nexports.getInitializationCommands = getInitializationCommands;\n/** Takes a generic value and escapes it so it can replace ? as a binding in a prepared SQL statement */\nfunction escapeSqlParameter(param) {\n    if (param === null || param === undefined) {\n        return 'NULL';\n    }\n    if (typeof param === 'string') {\n        // replace single quote with two single quotes\n        param = param.replace(/'/g, \"''\");\n        return `'${param}'`;\n    }\n    if (typeof param === 'number') {\n        return param.toString();\n    }\n    if (typeof param === 'boolean') {\n        return param ? '1' : '0';\n    }\n    // serialize buffer as X'...' hex encoded string\n    if (Buffer.isBuffer(param)) {\n        return `X'${param.toString('hex')}'`;\n    }\n    if (typeof param === 'object') {\n        // serialize json then escape single quotes\n        let json = JSON.stringify(param);\n        json = json.replace(/'/g, \"''\");\n        return `'${json}'`;\n    }\n    throw new types_1.SQLiteCloudError(`Unsupported parameter type: ${typeof param}`);\n}\nexports.escapeSqlParameter = escapeSqlParameter;\n/** Take a sql statement and replaces ? or $named parameters that are properly serialized and escaped. */\nfunction prepareSql(sql, ...params) {\n    // parameters where passed as an array of parameters?\n    if ((params === null || params === void 0 ? void 0 : params.length) === 1 && Array.isArray(params[0])) {\n        params = params[0];\n    }\n    // replace ? or ?idx parameters passed as args or as an array\n    let parameterIndex = 1;\n    let preparedSql = sql.replace(/\\?(\\d+)?/g, (match, matchIndex) => {\n        const index = matchIndex ? parseInt(matchIndex) : parameterIndex;\n        parameterIndex++;\n        let sqlParameter;\n        if (params[0] && typeof params[0] === 'object' && !(params[0] instanceof Buffer)) {\n            sqlParameter = params[0][index];\n        }\n        if (!sqlParameter) {\n            if (index > params.length) {\n                throw new types_1.SQLiteCloudError('Not enough parameters');\n            }\n            sqlParameter = params[index - 1];\n        }\n        return sqlParameter !== null && sqlParameter !== undefined ? escapeSqlParameter(sqlParameter) : 'NULL';\n    });\n    // replace $named or :named parameters passed as an object\n    if ((params === null || params === void 0 ? void 0 : params.length) === 1 && params[0] && typeof params[0] === 'object') {\n        const namedParams = params[0];\n        for (const [paramKey, param] of Object.entries(namedParams)) {\n            const firstChar = paramKey.charAt(0);\n            if (firstChar == '$' || firstChar == ':' || firstChar == '@') {\n                const escapedParam = escapeSqlParameter(param);\n                preparedSql = preparedSql.replace(new RegExp(`\\\\${paramKey}`, 'g'), escapedParam);\n            }\n        }\n    }\n    return preparedSql;\n}\nexports.prepareSql = prepareSql;\n/**\n * Many of the methods in our API may contain a callback as their last argument.\n * This method will take the arguments array passed to the method and return an object\n * containing the arguments array with the callbacks removed (if any), and the callback itself.\n * If there are multiple callbacks, the first one is returned as 'callback' and the last one\n * as 'completeCallback'.\n */\nfunction popCallback(args) {\n    const remaining = args;\n    // at least 1 callback?\n    if (args && args.length > 0 && typeof args[args.length - 1] === 'function') {\n        // at least 2 callbacks?\n        if (args.length > 1 && typeof args[args.length - 2] === 'function') {\n            return { args: remaining.slice(0, -2), callback: args[args.length - 2], complete: args[args.length - 1] };\n        }\n        return { args: remaining.slice(0, -1), callback: args[args.length - 1] };\n    }\n    return { args: remaining };\n}\nexports.popCallback = popCallback;\n//\n// configuration validation\n//\n/** Validate configuration, apply defaults, throw if something is missing or misconfigured */\nfunction validateConfiguration(config) {\n    console.assert(config, 'SQLiteCloudConnection.validateConfiguration - missing config');\n    if (config.connectionString) {\n        config = Object.assign(Object.assign(Object.assign({}, config), parseConnectionString(config.connectionString)), { connectionString: config.connectionString // keep original connection string\n         });\n    }\n    // apply defaults where needed\n    config.port || (config.port = types_1.DEFAULT_PORT);\n    config.timeout = config.timeout && config.timeout > 0 ? config.timeout : types_1.DEFAULT_TIMEOUT;\n    config.clientId || (config.clientId = 'SQLiteCloud');\n    config.verbose = parseBoolean(config.verbose);\n    config.noBlob = parseBoolean(config.noBlob);\n    config.compression = parseBoolean(config.compression);\n    config.createDatabase = parseBoolean(config.createDatabase);\n    config.nonlinearizable = parseBoolean(config.nonlinearizable);\n    config.insecure = parseBoolean(config.insecure);\n    if (!config.username || !config.password || !config.host) {\n        console.error('SQLiteCloudConnection.validateConfiguration - missing arguments', config);\n        throw new types_1.SQLiteCloudError('The user, password and host arguments must be specified.', { errorCode: 'ERR_MISSING_ARGS' });\n    }\n    if (!config.connectionString) {\n        // build connection string from configuration, values are already validated\n        // eslint-disable-next-line @typescript-eslint/restrict-template-expressions\n        config.connectionString = `sqlitecloud://${config.username}:${config.password}@${config.host}:${config.port}/${config.database}`;\n    }\n    return config;\n}\nexports.validateConfiguration = validateConfiguration;\n/** Parse connectionString like sqlitecloud://username:password@host:port/database?option1=xxx&option2=xxx into its components */\nfunction parseConnectionString(connectionString) {\n    try {\n        // The URL constructor throws a TypeError if the URL is not valid.\n        // in spite of having the same structure as a regular url\n        // protocol://username:password@host:port/database?option1=xxx&option2=xxx)\n        // the sqlitecloud: protocol is not recognized by the URL constructor in browsers\n        // so we need to replace it with https: to make it work\n        const knownProtocolUrl = connectionString.replace('sqlitecloud:', 'https:');\n        const url = new URL(knownProtocolUrl);\n        const options = {};\n        url.searchParams.forEach((value, key) => {\n            options[key] = value;\n        });\n        const config = Object.assign({ username: url.username, password: url.password, host: url.hostname, port: url.port ? parseInt(url.port) : undefined }, options);\n        const database = url.pathname.replace('/', ''); // pathname is database name, remove the leading slash\n        if (database) {\n            config.database = database;\n        }\n        return config;\n    }\n    catch (error) {\n        throw new types_1.SQLiteCloudError(`Invalid connection string: ${connectionString}`);\n    }\n}\nexports.parseConnectionString = parseConnectionString;\n/** Returns true if value is 1 or true */\nfunction parseBoolean(value) {\n    if (typeof value === 'string') {\n        return value.toLowerCase() === 'true' || value === '1';\n    }\n    return value ? true : false;\n}\nexports.parseBoolean = parseBoolean;\n\n\n//# sourceURL=webpack://sqlitecloud/./lib/drivers/utilities.js?");
+eval("\n//\n// utilities.ts - utility methods to manipulate SQL statements\n//\nObject.defineProperty(exports, \"__esModule\", ({ value: true }));\nexports.parseBoolean = exports.parseConnectionString = exports.validateConfiguration = exports.popCallback = exports.prepareSql = exports.escapeSqlParameter = exports.getInitializationCommands = exports.anonimizeError = exports.anonimizeCommand = exports.isNode = exports.isBrowser = void 0;\nconst types_1 = __webpack_require__(/*! ./types */ \"./lib/drivers/types.js\");\n//\n// determining running environment, thanks to browser-or-node\n// https://www.npmjs.com/package/browser-or-node\n//\nexports.isBrowser = typeof window !== 'undefined' && typeof window.document !== 'undefined';\nexports.isNode = typeof process !== 'undefined' && process.versions != null && process.versions.node != null;\n//\n// utility methods\n//\n/** Messages going to the server are sometimes logged when error conditions occour and need to be stripped of user credentials  */\nfunction anonimizeCommand(message) {\n    // hide password in AUTH command if needed\n    message = message.replace(/USER \\S+/, 'USER ******');\n    message = message.replace(/PASSWORD \\S+?(?=;)/, 'PASSWORD ******');\n    message = message.replace(/HASH \\S+?(?=;)/, 'HASH ******');\n    return message;\n}\nexports.anonimizeCommand = anonimizeCommand;\n/** Strip message code in error of user credentials */\nfunction anonimizeError(error) {\n    if (error === null || error === void 0 ? void 0 : error.message) {\n        error.message = anonimizeCommand(error.message);\n    }\n    return error;\n}\nexports.anonimizeError = anonimizeError;\n/** Initialization commands sent to database when connection is established */\nfunction getInitializationCommands(config) {\n    // first user authentication, then all other commands\n    let commands = `AUTH USER ${config.username || ''} ${config.passwordHashed ? 'HASH' : 'PASSWORD'} ${config.password || ''}; `;\n    if (config.database) {\n        if (config.createDatabase && !config.dbMemory) {\n            commands += `CREATE DATABASE ${config.database} IF NOT EXISTS; `;\n        }\n        commands += `USE DATABASE ${config.database}; `;\n    }\n    if (config.compression) {\n        commands += 'SET CLIENT KEY COMPRESSION TO 1; ';\n    }\n    if (config.nonlinearizable) {\n        commands += 'SET CLIENT KEY NONLINEARIZABLE TO 1; ';\n    }\n    if (config.noBlob) {\n        commands += 'SET CLIENT KEY NOBLOB TO 1; ';\n    }\n    if (config.maxData) {\n        commands += `SET CLIENT KEY MAXDATA TO ${config.maxData}; `;\n    }\n    if (config.maxRows) {\n        commands += `SET CLIENT KEY MAXROWS TO ${config.maxRows}; `;\n    }\n    if (config.maxRowset) {\n        commands += `SET CLIENT KEY MAXROWSET TO ${config.maxRowset}; `;\n    }\n    return commands;\n}\nexports.getInitializationCommands = getInitializationCommands;\n/** Takes a generic value and escapes it so it can replace ? as a binding in a prepared SQL statement */\nfunction escapeSqlParameter(param) {\n    if (param === null || param === undefined) {\n        return 'NULL';\n    }\n    if (typeof param === 'string') {\n        // replace single quote with two single quotes\n        param = param.replace(/'/g, \"''\");\n        return `'${param}'`;\n    }\n    if (typeof param === 'number') {\n        return param.toString();\n    }\n    if (typeof param === 'boolean') {\n        return param ? '1' : '0';\n    }\n    // serialize buffer as X'...' hex encoded string\n    if (Buffer.isBuffer(param)) {\n        return `X'${param.toString('hex')}'`;\n    }\n    if (typeof param === 'object') {\n        // serialize json then escape single quotes\n        let json = JSON.stringify(param);\n        json = json.replace(/'/g, \"''\");\n        return `'${json}'`;\n    }\n    throw new types_1.SQLiteCloudError(`Unsupported parameter type: ${typeof param}`);\n}\nexports.escapeSqlParameter = escapeSqlParameter;\n/** Take a sql statement and replaces ? or $named parameters that are properly serialized and escaped. */\nfunction prepareSql(sql, ...params) {\n    // parameters where passed as an array of parameters?\n    if ((params === null || params === void 0 ? void 0 : params.length) === 1 && Array.isArray(params[0])) {\n        params = params[0];\n    }\n    // replace ? or ?idx parameters passed as args or as an array\n    let parameterIndex = 1;\n    let preparedSql = sql.replace(/\\?(\\d+)?/g, (match, matchIndex) => {\n        const index = matchIndex ? parseInt(matchIndex) : parameterIndex;\n        parameterIndex++;\n        let sqlParameter;\n        if (params[0] && typeof params[0] === 'object' && !(params[0] instanceof Buffer)) {\n            sqlParameter = params[0][index];\n        }\n        if (!sqlParameter) {\n            if (index > params.length) {\n                throw new types_1.SQLiteCloudError('Not enough parameters');\n            }\n            sqlParameter = params[index - 1];\n        }\n        return sqlParameter !== null && sqlParameter !== undefined ? escapeSqlParameter(sqlParameter) : 'NULL';\n    });\n    // replace $named or :named parameters passed as an object\n    if ((params === null || params === void 0 ? void 0 : params.length) === 1 && params[0] && typeof params[0] === 'object') {\n        const namedParams = params[0];\n        for (const [paramKey, param] of Object.entries(namedParams)) {\n            const firstChar = paramKey.charAt(0);\n            if (firstChar == '$' || firstChar == ':' || firstChar == '@') {\n                const escapedParam = escapeSqlParameter(param);\n                preparedSql = preparedSql.replace(new RegExp(`\\\\${paramKey}`, 'g'), escapedParam);\n            }\n        }\n    }\n    return preparedSql;\n}\nexports.prepareSql = prepareSql;\n/**\n * Many of the methods in our API may contain a callback as their last argument.\n * This method will take the arguments array passed to the method and return an object\n * containing the arguments array with the callbacks removed (if any), and the callback itself.\n * If there are multiple callbacks, the first one is returned as 'callback' and the last one\n * as 'completeCallback'.\n */\nfunction popCallback(args) {\n    const remaining = args;\n    // at least 1 callback?\n    if (args && args.length > 0 && typeof args[args.length - 1] === 'function') {\n        // at least 2 callbacks?\n        if (args.length > 1 && typeof args[args.length - 2] === 'function') {\n            return { args: remaining.slice(0, -2), callback: args[args.length - 2], complete: args[args.length - 1] };\n        }\n        return { args: remaining.slice(0, -1), callback: args[args.length - 1] };\n    }\n    return { args: remaining };\n}\nexports.popCallback = popCallback;\n//\n// configuration validation\n//\n/** Validate configuration, apply defaults, throw if something is missing or misconfigured */\nfunction validateConfiguration(config) {\n    console.assert(config, 'SQLiteCloudConnection.validateConfiguration - missing config');\n    if (config.connectionString) {\n        config = Object.assign(Object.assign(Object.assign({}, config), parseConnectionString(config.connectionString)), { connectionString: config.connectionString // keep original connection string\n         });\n    }\n    // apply defaults where needed\n    config.port || (config.port = types_1.DEFAULT_PORT);\n    config.timeout = config.timeout && config.timeout > 0 ? config.timeout : types_1.DEFAULT_TIMEOUT;\n    config.clientId || (config.clientId = 'SQLiteCloud');\n    config.verbose = parseBoolean(config.verbose);\n    config.noBlob = parseBoolean(config.noBlob);\n    config.compression = parseBoolean(config.compression);\n    config.createDatabase = parseBoolean(config.createDatabase);\n    config.nonlinearizable = parseBoolean(config.nonlinearizable);\n    config.insecure = parseBoolean(config.insecure);\n    if (!config.username || !config.password || !config.host) {\n        console.error('SQLiteCloudConnection.validateConfiguration - missing arguments', config);\n        throw new types_1.SQLiteCloudError('The user, password and host arguments must be specified.', { errorCode: 'ERR_MISSING_ARGS' });\n    }\n    if (!config.connectionString) {\n        // build connection string from configuration, values are already validated\n        // eslint-disable-next-line @typescript-eslint/restrict-template-expressions\n        config.connectionString = `sqlitecloud://${encodeURIComponent(config.username)}:${encodeURIComponent(config.password)}@${config.host}:${config.port}/${config.database}`;\n    }\n    return config;\n}\nexports.validateConfiguration = validateConfiguration;\n/** Parse connectionString like sqlitecloud://username:password@host:port/database?option1=xxx&option2=xxx into its components */\nfunction parseConnectionString(connectionString) {\n    try {\n        // The URL constructor throws a TypeError if the URL is not valid.\n        // in spite of having the same structure as a regular url\n        // protocol://username:password@host:port/database?option1=xxx&option2=xxx)\n        // the sqlitecloud: protocol is not recognized by the URL constructor in browsers\n        // so we need to replace it with https: to make it work\n        const knownProtocolUrl = connectionString.replace('sqlitecloud:', 'https:');\n        const url = new URL(knownProtocolUrl);\n        const options = {};\n        url.searchParams.forEach((value, key) => {\n            options[key] = value;\n        });\n        const config = Object.assign({ username: decodeURIComponent(url.username), password: decodeURIComponent(url.password), host: url.hostname, port: url.port ? parseInt(url.port) : undefined }, options);\n        const database = url.pathname.replace('/', ''); // pathname is database name, remove the leading slash\n        if (database) {\n            config.database = database;\n        }\n        return config;\n    }\n    catch (error) {\n        throw new types_1.SQLiteCloudError(`Invalid connection string: ${connectionString}`);\n    }\n}\nexports.parseConnectionString = parseConnectionString;\n/** Returns true if value is 1 or true */\nfunction parseBoolean(value) {\n    if (typeof value === 'string') {\n        return value.toLowerCase() === 'true' || value === '1';\n    }\n    return value ? true : false;\n}\nexports.parseBoolean = parseBoolean;\n\n\n//# sourceURL=webpack://sqlitecloud/./lib/drivers/utilities.js?");
 
 /***/ }),
 
@@ -211,16 +211,6 @@ eval("/**\n * Helpers.\n */\n\nvar s = 1000;\nvar m = s * 60;\nvar h = m * 60;\n
 
 /***/ }),
 
-/***/ "?83b6":
-/*!*********************!*\
-  !*** net (ignored) ***!
-  \*********************/
-/***/ (() => {
-
-eval("/* (ignored) */\n\n//# sourceURL=webpack://sqlitecloud/net_(ignored)?");
-
-/***/ }),
-
 /***/ "?4235":
 /*!*********************!*\
   !*** tls (ignored) ***!