@sqlitecloud/drivers 1.0.715 → 1.0.738-rc.0

package/lib/sqlitecloud.drivers.dev.js

@@ -23,10 +23,10 @@ return /******/ (() => { // webpackBootstrap
 /*!***************************************!*\
   !*** ./lib/drivers/connection-tls.js ***!
   \***************************************/
-/***/ (function(__unused_webpack_module, exports, __webpack_require__) {
+/***/ ((__unused_webpack_module, exports, __webpack_require__) => {
 
 "use strict";
-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 () {\n    var ownKeys = function(o) {\n        ownKeys = Object.getOwnPropertyNames || function (o) {\n            var ar = [];\n            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;\n            return ar;\n        };\n        return ownKeys(o);\n    };\n    return function (mod) {\n        if (mod && mod.__esModule) return mod;\n        var result = {};\n        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== \"default\") __createBinding(result, mod, k[i]);\n        __setModuleDefault(result, mod);\n        return result;\n    };\n})();\nObject.defineProperty(exports, \"__esModule\", ({ value: true }));\nexports.SQLiteCloudTlsConnection = void 0;\nconst connection_1 = __webpack_require__(/*! ./connection */ \"./lib/drivers/connection.js\");\nconst protocol_1 = __webpack_require__(/*! ./protocol */ \"./lib/drivers/protocol.js\");\nconst types_1 = __webpack_require__(/*! ./types */ \"./lib/drivers/types.js\");\nconst utilities_1 = __webpack_require__(/*! ./utilities */ \"./lib/drivers/utilities.js\");\n// explicitly importing buffer library to allow cross-platform support by replacing it\nconst buffer_1 = __webpack_require__(/*! buffer */ \"./node_modules/buffer/index.js\");\nconst tls = __importStar(__webpack_require__(/*! tls */ \"?4235\"));\n/**\n * Implementation of SQLiteCloudConnection that connects to the database using specific tls 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_1.Buffer.alloc(0);\n        this.startedOn = new Date();\n        this.pendingChunks = [];\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    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: config.host != 'localhost',\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        // tls.connect in the react-native-tcp-socket library is tls.connectTLS\n        let connector = tls.connect;\n        // @ts-ignore\n        if (typeof tls.connectTLS !== 'undefined') {\n            // @ts-ignore\n            connector = tls.connectTLS;\n        }\n        this.processCallback = callback;\n        this.socket = connector(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.setKeepAlive(true);\n        // disable Nagle algorithm because we want our writes to be sent ASAP\n        // https://brooker.co.za/blog/2024/05/09/nagle.html\n        this.socket.setNoDelay(true);\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        this.socket.on('timeout', () => {\n            this.close();\n            this.processCommandsFinish(new types_1.SQLiteCloudError('Connection ened due to timeout', { errorCode: 'ERR_CONNECTION_TIMEOUT' }));\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        if (typeof commands === 'string') {\n            commands = { query: commands };\n        }\n        // reset buffer and rowset chunks, define response callback\n        this.buffer = buffer_1.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, () => {\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);\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, _g;\n        try {\n            // append data to buffer as it arrives\n            if (data.length && data.length > 0) {\n                // console.debug(`processCommandsData - received ${data.length} bytes`)\n                this.buffer = buffer_1.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} (${bufferString.length} bytes, ${elapsedMs}ms)`);\n                    }\n                    // need to decompress this buffer before decoding?\n                    if (dataType === protocol_1.CMD_COMPRESSED) {\n                        const decompressResults = (0, protocol_1.decompressBuffer)(this.buffer);\n                        if (decompressResults.dataType === protocol_1.CMD_ROWSET_CHUNK) {\n                            this.pendingChunks.push(decompressResults.buffer);\n                            this.buffer = decompressResults.remainingBuffer;\n                            this.processCommandsData(buffer_1.Buffer.alloc(0));\n                            return;\n                        }\n                        else {\n                            const { data } = (0, protocol_1.popData)(decompressResults.buffer);\n                            (_c = this.processCommandsFinish) === null || _c === void 0 ? void 0 : _c.call(this, null, data);\n                        }\n                    }\n                    else {\n                        if (dataType !== protocol_1.CMD_ROWSET_CHUNK) {\n                            const { data } = (0, protocol_1.popData)(this.buffer);\n                            (_d = this.processCommandsFinish) === null || _d === void 0 ? void 0 : _d.call(this, null, data);\n                        }\n                        else {\n                            const completeChunk = (0, protocol_1.bufferEndsWith)(this.buffer, protocol_1.ROWSET_CHUNKS_END);\n                            if (completeChunk) {\n                                const parsedData = (0, protocol_1.parseRowsetChunks)([...this.pendingChunks, this.buffer]);\n                                (_e = this.processCommandsFinish) === null || _e === void 0 ? void 0 : _e.call(this, null, parsedData);\n                            }\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                    (_f = this.processCommandsFinish) === null || _f === void 0 ? void 0 : _f.call(this, null, data);\n                }\n            }\n        }\n        catch (error) {\n            console.error(`processCommandsData - error: ${error}`);\n            console.assert(error instanceof Error, 'An error occoured while processing data');\n            if (error instanceof Error) {\n                (_g = this.processCommandsFinish) === null || _g === void 0 ? void 0 : _g.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        }\n        this.buffer = buffer_1.Buffer.alloc(0);\n        this.pendingChunks = [];\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?");
+eval("\n/**\n * connection-tls.ts - connection via tls socket and sqlitecloud protocol\n */\nObject.defineProperty(exports, \"__esModule\", ({ value: true }));\nexports.SQLiteCloudTlsConnection = void 0;\nconst connection_1 = __webpack_require__(/*! ./connection */ \"./lib/drivers/connection.js\");\nconst protocol_1 = __webpack_require__(/*! ./protocol */ \"./lib/drivers/protocol.js\");\nconst types_1 = __webpack_require__(/*! ./types */ \"./lib/drivers/types.js\");\nconst utilities_1 = __webpack_require__(/*! ./utilities */ \"./lib/drivers/utilities.js\");\nconst safe_imports_1 = __webpack_require__(/*! ./safe-imports */ \"./lib/drivers/safe-imports.js\");\n// explicitly importing buffer library to allow cross-platform support by replacing it\n// In React Native: Metro resolves 'buffer' to '@craftzdog/react-native-buffer' via package.json react-native field\n// In Web/Node: Uses standard buffer package\nconst Buffer = (0, safe_imports_1.getSafeBuffer)();\n// In React Native: Metro resolves 'tls' to 'react-native-tcp-socket' via package.json react-native field\n// In Node: Uses native tls module\n// In Browser: Returns null (browser field sets tls to false)\nconst tls = (0, safe_imports_1.getSafeTLS)();\n/**\n * Implementation of SQLiteCloudConnection that connects to the database using specific tls 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        this.pendingChunks = [];\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    connectTransport(config, callback) {\n        console.assert(!this.connected, 'SQLiteCloudTlsConnection.connect - connection already established');\n        // Check if tls is available (it's null in browser contexts)\n        if (!tls) {\n            const error = new types_1.SQLiteCloudError('TLS connections are not available in this environment. Use WebSocket connections instead by setting usewebsocket: true in your configuration.', { errorCode: 'ERR_TLS_NOT_AVAILABLE' });\n            if (callback) {\n                callback.call(this, error);\n                return this;\n            }\n            throw error;\n        }\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: config.host != 'localhost',\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        // tls.connect in the react-native-tcp-socket library is tls.connectTLS\n        let connector = tls.connect;\n        // @ts-ignore\n        if (typeof tls.connectTLS !== 'undefined') {\n            // @ts-ignore\n            connector = tls.connectTLS;\n        }\n        this.processCallback = callback;\n        this.socket = connector(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.setKeepAlive(true);\n        // disable Nagle algorithm because we want our writes to be sent ASAP\n        // https://brooker.co.za/blog/2024/05/09/nagle.html\n        this.socket.setNoDelay(true);\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        this.socket.on('timeout', () => {\n            this.close();\n            this.processCommandsFinish(new types_1.SQLiteCloudError('Connection ened due to timeout', { errorCode: 'ERR_CONNECTION_TIMEOUT' }));\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        if (typeof commands === 'string') {\n            commands = { query: commands };\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, () => {\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);\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, _g;\n        try {\n            // append data to buffer as it arrives\n            if (data.length && data.length > 0) {\n                // console.debug(`processCommandsData - received ${data.length} bytes`)\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} (${bufferString.length} bytes, ${elapsedMs}ms)`);\n                    }\n                    // need to decompress this buffer before decoding?\n                    if (dataType === protocol_1.CMD_COMPRESSED) {\n                        const decompressResults = (0, protocol_1.decompressBuffer)(this.buffer);\n                        if (decompressResults.dataType === protocol_1.CMD_ROWSET_CHUNK) {\n                            this.pendingChunks.push(decompressResults.buffer);\n                            this.buffer = decompressResults.remainingBuffer;\n                            this.processCommandsData(Buffer.alloc(0));\n                            return;\n                        }\n                        else {\n                            const { data } = (0, protocol_1.popData)(decompressResults.buffer);\n                            (_c = this.processCommandsFinish) === null || _c === void 0 ? void 0 : _c.call(this, null, data);\n                        }\n                    }\n                    else {\n                        if (dataType !== protocol_1.CMD_ROWSET_CHUNK) {\n                            const { data } = (0, protocol_1.popData)(this.buffer);\n                            (_d = this.processCommandsFinish) === null || _d === void 0 ? void 0 : _d.call(this, null, data);\n                        }\n                        else {\n                            const completeChunk = (0, protocol_1.bufferEndsWith)(this.buffer, protocol_1.ROWSET_CHUNKS_END);\n                            if (completeChunk) {\n                                const parsedData = (0, protocol_1.parseRowsetChunks)([...this.pendingChunks, this.buffer]);\n                                (_e = this.processCommandsFinish) === null || _e === void 0 ? void 0 : _e.call(this, null, parsedData);\n                            }\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                    (_f = this.processCommandsFinish) === null || _f === void 0 ? void 0 : _f.call(this, null, data);\n                }\n            }\n        }\n        catch (error) {\n            console.error(`processCommandsData - error: ${error}`);\n            console.assert(error instanceof Error, 'An error occoured while processing data');\n            if (error instanceof Error) {\n                (_g = this.processCommandsFinish) === null || _g === void 0 ? void 0 : _g.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        }\n        this.buffer = Buffer.alloc(0);\n        this.pendingChunks = [];\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?");
 
 /***/ }),
 
@@ -70,7 +70,7 @@ eval("\n//\n// database.ts - database driver api, implements and extends sqlite3
 /***/ ((__unused_webpack_module, exports, __webpack_require__) => {
 
 "use strict";
-eval("\n//\n// protocol.ts - low level protocol handling for SQLiteCloud transport\n//\nObject.defineProperty(exports, \"__esModule\", ({ value: true }));\nexports.ROWSET_CHUNKS_END = exports.CMD_PUBSUB = exports.CMD_ARRAY = exports.CMD_COMMAND = exports.CMD_COMPRESSED = exports.CMD_BLOB = exports.CMD_NULL = exports.CMD_JSON = exports.CMD_ROWSET_CHUNK = exports.CMD_ROWSET = exports.CMD_FLOAT = exports.CMD_INT = exports.CMD_ERROR = exports.CMD_ZEROSTRING = exports.CMD_STRING = void 0;\nexports.hasCommandLength = hasCommandLength;\nexports.parseCommandLength = parseCommandLength;\nexports.decompressBuffer = decompressBuffer;\nexports.parseError = parseError;\nexports.parseArray = parseArray;\nexports.parseRowsetHeader = parseRowsetHeader;\nexports.bufferStartsWith = bufferStartsWith;\nexports.bufferEndsWith = bufferEndsWith;\nexports.parseRowsetChunks = parseRowsetChunks;\nexports.popData = popData;\nexports.formatCommand = formatCommand;\nconst rowset_1 = __webpack_require__(/*! ./rowset */ \"./lib/drivers/rowset.js\");\nconst types_1 = __webpack_require__(/*! ./types */ \"./lib/drivers/types.js\");\n// explicitly importing buffer library to allow cross-platform support by replacing it\nconst buffer_1 = __webpack_require__(/*! buffer */ \"./node_modules/buffer/index.js\");\n// https://www.npmjs.com/package/lz4js\nconst lz4 = __webpack_require__(/*! lz4js */ \"./node_modules/lz4js/lz4.js\");\n// The server communicates with clients via commands defined in\n// SQLiteCloud Server Protocol (SCSP), see more at:\n// https://github.com/sqlitecloud/sdk/blob/master/PROTOCOL.md\nexports.CMD_STRING = '+';\nexports.CMD_ZEROSTRING = '!';\nexports.CMD_ERROR = '-';\nexports.CMD_INT = ':';\nexports.CMD_FLOAT = ',';\nexports.CMD_ROWSET = '*';\nexports.CMD_ROWSET_CHUNK = '/';\nexports.CMD_JSON = '#';\nexports.CMD_NULL = '_';\nexports.CMD_BLOB = '$';\nexports.CMD_COMPRESSED = '%';\nexports.CMD_COMMAND = '^';\nexports.CMD_ARRAY = '=';\n// const CMD_RAWJSON = '{'\nexports.CMD_PUBSUB = '|';\n// const CMD_RECONNECT = '@'\n// To mark the end of the Rowset, the special string /LEN 0 0 0   is sent (LEN is always 6 in this case)\n// https://github.com/sqlitecloud/sdk/blob/master/PROTOCOL.md#scsp-rowset-chunk\nexports.ROWSET_CHUNKS_END = '/6 0 0 0 ';\n//\n// utility functions\n//\n/** Analyze first character to check if corresponding data type has LEN */\nfunction hasCommandLength(firstCharacter) {\n    return firstCharacter == exports.CMD_INT || firstCharacter == exports.CMD_FLOAT || firstCharacter == exports.CMD_NULL ? false : true;\n}\n/** Analyze a command with explict LEN and extract it */\nfunction parseCommandLength(data) {\n    return parseInt(data.subarray(1, data.indexOf(' ')).toString('utf8'));\n}\n/** Receive a compressed buffer, decompress with lz4, return buffer and datatype */\nfunction decompressBuffer(buffer) {\n    // https://github.com/sqlitecloud/sdk/blob/master/PROTOCOL.md#scsp-compression\n    // jest test/database.test.ts -t \"select large result set\"\n    // starts with %<commandLength> <compressed> <uncompressed>\n    const spaceIndex = buffer.indexOf(' ');\n    const commandLength = parseInt(buffer.subarray(1, spaceIndex).toString('utf8'));\n    let commandBuffer = buffer.subarray(spaceIndex + 1, spaceIndex + 1 + commandLength);\n    const remainingBuffer = buffer.subarray(spaceIndex + 1 + commandLength);\n    // extract compressed + decompressed  size\n    const compressedSize = parseInt(commandBuffer.subarray(0, commandBuffer.indexOf(' ') + 1).toString('utf8'));\n    commandBuffer = commandBuffer.subarray(commandBuffer.indexOf(' ') + 1);\n    const decompressedSize = parseInt(commandBuffer.subarray(0, commandBuffer.indexOf(' ') + 1).toString('utf8'));\n    commandBuffer = commandBuffer.subarray(commandBuffer.indexOf(' ') + 1);\n    // extract compressed dataType\n    const dataType = commandBuffer.subarray(0, 1).toString('utf8');\n    let decompressedBuffer = buffer_1.Buffer.alloc(decompressedSize);\n    const compressedBuffer = commandBuffer.subarray(commandBuffer.length - compressedSize);\n    // lz4js library is javascript and doesn't have types so we silence the type check\n    const decompressionResult = lz4.decompressBlock(compressedBuffer, decompressedBuffer, 0, compressedSize, 0);\n    // the entire command is composed of the header (which is not compressed) + the decompressed block\n    decompressedBuffer = buffer_1.Buffer.concat([commandBuffer.subarray(0, commandBuffer.length - compressedSize), decompressedBuffer]);\n    if (decompressionResult <= 0 || decompressionResult !== decompressedSize) {\n        throw new Error(`lz4 decompression error at offset ${decompressionResult}`);\n    }\n    return { buffer: decompressedBuffer, dataType, remainingBuffer };\n}\n/** Parse error message or extended error message */\nfunction parseError(buffer, spaceIndex) {\n    const errorBuffer = buffer.subarray(spaceIndex + 1);\n    const errorString = errorBuffer.toString('utf8');\n    const parts = errorString.split(' ');\n    let errorCodeStr = parts.shift() || '0'; // Default errorCode is '0' if not present\n    let extErrCodeStr = '0'; // Default extended error code\n    let offsetCodeStr = '-1'; // Default offset code\n    // Split the errorCode by ':' to check for extended error codes\n    const errorCodeParts = errorCodeStr.split(':');\n    errorCodeStr = errorCodeParts[0];\n    if (errorCodeParts.length > 1) {\n        extErrCodeStr = errorCodeParts[1];\n        if (errorCodeParts.length > 2) {\n            offsetCodeStr = errorCodeParts[2];\n        }\n    }\n    // Rest of the error string is the error message\n    const errorMessage = parts.join(' ');\n    // Parse error codes to integers safely, defaulting to 0 if NaN\n    const errorCode = parseInt(errorCodeStr);\n    const extErrCode = parseInt(extErrCodeStr);\n    const offsetCode = parseInt(offsetCodeStr);\n    // create an Error object and add the custom properties\n    throw new types_1.SQLiteCloudError(errorMessage, {\n        errorCode: errorCode.toString(),\n        externalErrorCode: extErrCode.toString(),\n        offsetCode\n    });\n}\n/** Parse an array of items (each of which will be parsed by type separately) */\nfunction parseArray(buffer, spaceIndex) {\n    const parsedData = [];\n    const array = buffer.subarray(spaceIndex + 1, buffer.length);\n    const numberOfItems = parseInt(array.subarray(0, spaceIndex - 2).toString('utf8'));\n    let arrayItems = array.subarray(array.indexOf(' ') + 1, array.length);\n    for (let i = 0; i < numberOfItems; i++) {\n        const { data, fwdBuffer: buffer } = popData(arrayItems);\n        parsedData.push(data);\n        arrayItems = buffer;\n    }\n    return parsedData;\n}\n/** Parse header in a rowset or chunk of a chunked rowset */\nfunction parseRowsetHeader(buffer) {\n    const index = parseInt(buffer.subarray(0, buffer.indexOf(':') + 1).toString());\n    buffer = buffer.subarray(buffer.indexOf(':') + 1);\n    // extract rowset header\n    const { data, fwdBuffer } = popIntegers(buffer, 3);\n    const result = {\n        index,\n        metadata: {\n            version: data[0],\n            numberOfRows: data[1],\n            numberOfColumns: data[2],\n            columns: []\n        },\n        fwdBuffer\n    };\n    // console.debug(`parseRowsetHeader`, result)\n    return result;\n}\n/** Extract column names and, optionally, more metadata out of a rowset's header */\nfunction parseRowsetColumnsMetadata(buffer, metadata) {\n    function popForward() {\n        const { data, fwdBuffer: fwdBuffer } = popData(buffer); // buffer in parent scope\n        buffer = fwdBuffer;\n        return data;\n    }\n    for (let i = 0; i < metadata.numberOfColumns; i++) {\n        metadata.columns.push({ name: popForward() });\n    }\n    // extract additional metadata if rowset has version 2\n    if (metadata.version == 2) {\n        for (let i = 0; i < metadata.numberOfColumns; i++)\n            metadata.columns[i].type = popForward();\n        for (let i = 0; i < metadata.numberOfColumns; i++)\n            metadata.columns[i].database = popForward();\n        for (let i = 0; i < metadata.numberOfColumns; i++)\n            metadata.columns[i].table = popForward();\n        for (let i = 0; i < metadata.numberOfColumns; i++)\n            metadata.columns[i].column = popForward(); // original column name\n        for (let i = 0; i < metadata.numberOfColumns; i++)\n            metadata.columns[i].notNull = popForward();\n        for (let i = 0; i < metadata.numberOfColumns; i++)\n            metadata.columns[i].primaryKey = popForward();\n        for (let i = 0; i < metadata.numberOfColumns; i++)\n            metadata.columns[i].autoIncrement = popForward();\n    }\n    return buffer;\n}\n/** Parse a regular rowset (no chunks) */\nfunction parseRowset(buffer, spaceIndex) {\n    buffer = buffer.subarray(spaceIndex + 1, buffer.length);\n    const { metadata, fwdBuffer } = parseRowsetHeader(buffer);\n    buffer = parseRowsetColumnsMetadata(fwdBuffer, metadata);\n    // decode each rowset item\n    const data = [];\n    for (let j = 0; j < metadata.numberOfRows * metadata.numberOfColumns; j++) {\n        const { data: rowData, fwdBuffer } = popData(buffer);\n        data.push(rowData);\n        buffer = fwdBuffer;\n    }\n    console.assert(data && data.length === metadata.numberOfRows * metadata.numberOfColumns, 'SQLiteCloudConnection.parseRowset - invalid rowset data');\n    return new rowset_1.SQLiteCloudRowset(metadata, data);\n}\nfunction bufferStartsWith(buffer, prefix) {\n    return buffer.length >= prefix.length && buffer.subarray(0, prefix.length).toString('utf8') === prefix;\n}\nfunction bufferEndsWith(buffer, suffix) {\n    return buffer.length >= suffix.length && buffer.subarray(buffer.length - suffix.length, buffer.length).toString('utf8') === suffix;\n}\n/**\n * Parse a chunk of a chunked rowset command, eg:\n * *LEN 0:VERS NROWS NCOLS DATA\n * @see https://github.com/sqlitecloud/sdk/blob/master/PROTOCOL.md#scsp-rowset-chunk\n */\nfunction parseRowsetChunks(buffers) {\n    let buffer = buffer_1.Buffer.concat(buffers);\n    if (!bufferStartsWith(buffer, exports.CMD_ROWSET_CHUNK) || !bufferEndsWith(buffer, exports.ROWSET_CHUNKS_END)) {\n        throw new Error('SQLiteCloudConnection.parseRowsetChunks - invalid chunks buffer');\n    }\n    let metadata = { version: 1, numberOfColumns: 0, numberOfRows: 0, columns: [] };\n    const data = [];\n    // validate and skip data type\n    const dataType = buffer.subarray(0, 1).toString();\n    if (dataType !== exports.CMD_ROWSET_CHUNK)\n        throw new Error(`parseRowsetChunks - dataType: ${dataType} should be CMD_ROWSET_CHUNK`);\n    buffer = buffer.subarray(buffer.indexOf(' ') + 1);\n    while (buffer.length > 0 && !bufferStartsWith(buffer, exports.ROWSET_CHUNKS_END)) {\n        // chunk header, eg: 0:VERS NROWS NCOLS\n        const { index: chunkIndex, metadata: chunkMetadata, fwdBuffer } = parseRowsetHeader(buffer);\n        buffer = fwdBuffer;\n        // first chunk? extract columns metadata\n        if (chunkIndex === 1) {\n            metadata = chunkMetadata;\n            buffer = parseRowsetColumnsMetadata(buffer, metadata);\n        }\n        else {\n            metadata.numberOfRows += chunkMetadata.numberOfRows;\n        }\n        // extract single rowset row\n        for (let k = 0; k < chunkMetadata.numberOfRows * metadata.numberOfColumns; k++) {\n            const { data: itemData, fwdBuffer } = popData(buffer);\n            data.push(itemData);\n            buffer = fwdBuffer;\n        }\n    }\n    console.assert(data && data.length === metadata.numberOfRows * metadata.numberOfColumns, 'parseRowsetChunks - invalid rowset data');\n    const rowset = new rowset_1.SQLiteCloudRowset(metadata, data);\n    // console.debug(`parseRowsetChunks - ${rowset.numberOfRows} rows, ${rowset.numberOfColumns} columns`)\n    return rowset;\n}\n/** Pop one or more space separated integers from beginning of buffer, move buffer forward */\nfunction popIntegers(buffer, numberOfIntegers = 1) {\n    const data = [];\n    for (let i = 0; i < numberOfIntegers; i++) {\n        const spaceIndex = buffer.indexOf(' ');\n        data[i] = parseInt(buffer.subarray(0, spaceIndex).toString());\n        buffer = buffer.subarray(spaceIndex + 1);\n    }\n    return { data, fwdBuffer: buffer };\n}\n/** Parse command, extract its data, return the data and the buffer moved to the first byte after the command */\nfunction popData(buffer) {\n    function popResults(data) {\n        const fwdBuffer = buffer.subarray(commandEnd);\n        return { data, fwdBuffer };\n    }\n    // first character is the data type\n    console.assert(buffer && buffer instanceof buffer_1.Buffer);\n    let dataType = buffer.subarray(0, 1).toString('utf8');\n    if (dataType == exports.CMD_COMPRESSED)\n        throw new Error('Compressed data should be decompressed before parsing');\n    if (dataType == exports.CMD_ROWSET_CHUNK)\n        throw new Error('Chunked data should be parsed by parseRowsetChunks');\n    let spaceIndex = buffer.indexOf(' ');\n    if (spaceIndex === -1) {\n        spaceIndex = buffer.length - 1;\n    }\n    let commandEnd = -1, commandLength = -1;\n    if (dataType === exports.CMD_INT || dataType === exports.CMD_FLOAT || dataType === exports.CMD_NULL) {\n        commandEnd = spaceIndex + 1;\n    }\n    else {\n        commandLength = parseInt(buffer.subarray(1, spaceIndex).toString());\n        commandEnd = spaceIndex + 1 + commandLength;\n    }\n    // console.debug(`popData - dataType: ${dataType}, spaceIndex: ${spaceIndex}, commandLength: ${commandLength}, commandEnd: ${commandEnd}`)\n    switch (dataType) {\n        case exports.CMD_INT:\n            // SQLite uses 64-bit INTEGER, but JS uses 53-bit Number\n            const value = BigInt(buffer.subarray(1, spaceIndex).toString());\n            if (types_1.SAFE_INTEGER_MODE === 'bigint') {\n                return popResults(value);\n            }\n            if (types_1.SAFE_INTEGER_MODE === 'mixed') {\n                if (value <= BigInt(Number.MIN_SAFE_INTEGER) || BigInt(Number.MAX_SAFE_INTEGER) <= value) {\n                    return popResults(value);\n                }\n            }\n            return popResults(Number(value));\n        case exports.CMD_FLOAT:\n            return popResults(parseFloat(buffer.subarray(1, spaceIndex).toString()));\n        case exports.CMD_NULL:\n            return popResults(null);\n        case exports.CMD_STRING:\n            return popResults(buffer.subarray(spaceIndex + 1, commandEnd).toString('utf8'));\n        case exports.CMD_ZEROSTRING:\n            return popResults(buffer.subarray(spaceIndex + 1, commandEnd - 1).toString('utf8'));\n        case exports.CMD_COMMAND:\n            return popResults(buffer.subarray(spaceIndex + 1, commandEnd).toString('utf8'));\n        case exports.CMD_PUBSUB:\n            return popResults(buffer.subarray(spaceIndex + 1, commandEnd).toString('utf8'));\n        case exports.CMD_JSON:\n            return popResults(JSON.parse(buffer.subarray(spaceIndex + 1, commandEnd).toString('utf8')));\n        case exports.CMD_BLOB:\n            return popResults(buffer.subarray(spaceIndex + 1, commandEnd));\n        case exports.CMD_ARRAY:\n            return popResults(parseArray(buffer, spaceIndex));\n        case exports.CMD_ROWSET:\n            return popResults(parseRowset(buffer, spaceIndex));\n        case exports.CMD_ERROR:\n            parseError(buffer, spaceIndex); // throws custom error\n            break;\n    }\n    const msg = `popData - Data type: ${Number(dataType)} '${dataType}'  is not defined in SCSP, spaceIndex: ${spaceIndex}, commandLength: ${commandLength}, commandEnd: ${commandEnd}`;\n    console.error(msg);\n    throw new TypeError(msg);\n}\n/** Format a command to be sent via SCSP protocol */\nfunction formatCommand(command) {\n    // core returns null if there's a space after the semi column\n    // we want to maintain a compatibility with the standard sqlite3 driver\n    command.query = command.query.trim();\n    if (command.parameters && command.parameters.length > 0) {\n        // by SCSP the string paramenters in the array are zero-terminated\n        return serializeCommand([command.query, ...(command.parameters || [])], true);\n    }\n    return serializeData(command.query, false);\n}\nfunction serializeCommand(data, zeroString = false) {\n    const n = data.length;\n    let serializedData = buffer_1.Buffer.from(`${n} `);\n    for (let i = 0; i < n; i++) {\n        // the first string is the sql and it must be zero-terminated\n        const zs = i == 0 || zeroString;\n        serializedData = buffer_1.Buffer.concat([serializedData, serializeData(data[i], zs)]);\n    }\n    const bytesTotal = serializedData.byteLength;\n    const header = buffer_1.Buffer.from(`${exports.CMD_ARRAY}${bytesTotal} `);\n    return buffer_1.Buffer.concat([header, serializedData]);\n}\nfunction serializeData(data, zeroString = false) {\n    if (typeof data === 'string') {\n        let cmd = exports.CMD_STRING;\n        if (zeroString) {\n            cmd = exports.CMD_ZEROSTRING;\n            data += '\\0';\n        }\n        const header = `${cmd}${buffer_1.Buffer.byteLength(data, 'utf-8')} `;\n        return buffer_1.Buffer.from(header + data);\n    }\n    if (typeof data === 'number') {\n        if (Number.isInteger(data)) {\n            return buffer_1.Buffer.from(`${exports.CMD_INT}${data} `);\n        }\n        else {\n            return buffer_1.Buffer.from(`${exports.CMD_FLOAT}${data} `);\n        }\n    }\n    if (typeof data === 'bigint') {\n        return buffer_1.Buffer.from(`${exports.CMD_INT}${data} `);\n    }\n    if (buffer_1.Buffer.isBuffer(data)) {\n        const header = `${exports.CMD_BLOB}${data.byteLength} `;\n        return buffer_1.Buffer.concat([buffer_1.Buffer.from(header), data]);\n    }\n    if (data === null || data === undefined) {\n        return buffer_1.Buffer.from(`${exports.CMD_NULL} `);\n    }\n    if (Array.isArray(data)) {\n        return serializeCommand(data, zeroString);\n    }\n    throw new Error(`Unsupported data type for serialization: ${typeof data}`);\n}\n\n\n//# sourceURL=webpack://sqlitecloud/./lib/drivers/protocol.js?");
+eval("\n//\n// protocol.ts - low level protocol handling for SQLiteCloud transport\n//\nObject.defineProperty(exports, \"__esModule\", ({ value: true }));\nexports.ROWSET_CHUNKS_END = exports.CMD_PUBSUB = exports.CMD_ARRAY = exports.CMD_COMMAND = exports.CMD_COMPRESSED = exports.CMD_BLOB = exports.CMD_NULL = exports.CMD_JSON = exports.CMD_ROWSET_CHUNK = exports.CMD_ROWSET = exports.CMD_FLOAT = exports.CMD_INT = exports.CMD_ERROR = exports.CMD_ZEROSTRING = exports.CMD_STRING = void 0;\nexports.hasCommandLength = hasCommandLength;\nexports.parseCommandLength = parseCommandLength;\nexports.decompressBuffer = decompressBuffer;\nexports.parseError = parseError;\nexports.parseArray = parseArray;\nexports.parseRowsetHeader = parseRowsetHeader;\nexports.bufferStartsWith = bufferStartsWith;\nexports.bufferEndsWith = bufferEndsWith;\nexports.parseRowsetChunks = parseRowsetChunks;\nexports.popData = popData;\nexports.formatCommand = formatCommand;\nconst rowset_1 = __webpack_require__(/*! ./rowset */ \"./lib/drivers/rowset.js\");\nconst types_1 = __webpack_require__(/*! ./types */ \"./lib/drivers/types.js\");\nconst safe_imports_1 = __webpack_require__(/*! ./safe-imports */ \"./lib/drivers/safe-imports.js\");\n// explicitly importing buffer library to allow cross-platform support by replacing it\n// In React Native: Metro resolves 'buffer' to '@craftzdog/react-native-buffer' via package.json react-native field\n// In Web/Node: Uses standard buffer package\nconst Buffer = (0, safe_imports_1.getSafeBuffer)();\n// https://www.npmjs.com/package/lz4js\nconst lz4 = __webpack_require__(/*! lz4js */ \"./node_modules/lz4js/lz4.js\");\n// The server communicates with clients via commands defined in\n// SQLiteCloud Server Protocol (SCSP), see more at:\n// https://github.com/sqlitecloud/sdk/blob/master/PROTOCOL.md\nexports.CMD_STRING = '+';\nexports.CMD_ZEROSTRING = '!';\nexports.CMD_ERROR = '-';\nexports.CMD_INT = ':';\nexports.CMD_FLOAT = ',';\nexports.CMD_ROWSET = '*';\nexports.CMD_ROWSET_CHUNK = '/';\nexports.CMD_JSON = '#';\nexports.CMD_NULL = '_';\nexports.CMD_BLOB = '$';\nexports.CMD_COMPRESSED = '%';\nexports.CMD_COMMAND = '^';\nexports.CMD_ARRAY = '=';\n// const CMD_RAWJSON = '{'\nexports.CMD_PUBSUB = '|';\n// const CMD_RECONNECT = '@'\n// To mark the end of the Rowset, the special string /LEN 0 0 0   is sent (LEN is always 6 in this case)\n// https://github.com/sqlitecloud/sdk/blob/master/PROTOCOL.md#scsp-rowset-chunk\nexports.ROWSET_CHUNKS_END = '/6 0 0 0 ';\n//\n// utility functions\n//\n/** Analyze first character to check if corresponding data type has LEN */\nfunction hasCommandLength(firstCharacter) {\n    return firstCharacter == exports.CMD_INT || firstCharacter == exports.CMD_FLOAT || firstCharacter == exports.CMD_NULL ? false : true;\n}\n/** Analyze a command with explict LEN and extract it */\nfunction parseCommandLength(data) {\n    return parseInt(data.subarray(1, data.indexOf(' ')).toString('utf8'));\n}\n/** Receive a compressed buffer, decompress with lz4, return buffer and datatype */\nfunction decompressBuffer(buffer) {\n    // https://github.com/sqlitecloud/sdk/blob/master/PROTOCOL.md#scsp-compression\n    // jest test/database.test.ts -t \"select large result set\"\n    // starts with %<commandLength> <compressed> <uncompressed>\n    const spaceIndex = buffer.indexOf(' ');\n    const commandLength = parseInt(buffer.subarray(1, spaceIndex).toString('utf8'));\n    let commandBuffer = buffer.subarray(spaceIndex + 1, spaceIndex + 1 + commandLength);\n    const remainingBuffer = buffer.subarray(spaceIndex + 1 + commandLength);\n    // extract compressed + decompressed  size\n    const compressedSize = parseInt(commandBuffer.subarray(0, commandBuffer.indexOf(' ') + 1).toString('utf8'));\n    commandBuffer = commandBuffer.subarray(commandBuffer.indexOf(' ') + 1);\n    const decompressedSize = parseInt(commandBuffer.subarray(0, commandBuffer.indexOf(' ') + 1).toString('utf8'));\n    commandBuffer = commandBuffer.subarray(commandBuffer.indexOf(' ') + 1);\n    // extract compressed dataType\n    const dataType = commandBuffer.subarray(0, 1).toString('utf8');\n    let decompressedBuffer = Buffer.alloc(decompressedSize);\n    const compressedBuffer = commandBuffer.subarray(commandBuffer.length - compressedSize);\n    // lz4js library is javascript and doesn't have types so we silence the type check\n    const decompressionResult = lz4.decompressBlock(compressedBuffer, decompressedBuffer, 0, compressedSize, 0);\n    // the entire command is composed of the header (which is not compressed) + the decompressed block\n    decompressedBuffer = Buffer.concat([commandBuffer.subarray(0, commandBuffer.length - compressedSize), decompressedBuffer]);\n    if (decompressionResult <= 0 || decompressionResult !== decompressedSize) {\n        throw new Error(`lz4 decompression error at offset ${decompressionResult}`);\n    }\n    return { buffer: decompressedBuffer, dataType, remainingBuffer };\n}\n/** Parse error message or extended error message */\nfunction parseError(buffer, spaceIndex) {\n    const errorBuffer = buffer.subarray(spaceIndex + 1);\n    const errorString = errorBuffer.toString('utf8');\n    const parts = errorString.split(' ');\n    let errorCodeStr = parts.shift() || '0'; // Default errorCode is '0' if not present\n    let extErrCodeStr = '0'; // Default extended error code\n    let offsetCodeStr = '-1'; // Default offset code\n    // Split the errorCode by ':' to check for extended error codes\n    const errorCodeParts = errorCodeStr.split(':');\n    errorCodeStr = errorCodeParts[0];\n    if (errorCodeParts.length > 1) {\n        extErrCodeStr = errorCodeParts[1];\n        if (errorCodeParts.length > 2) {\n            offsetCodeStr = errorCodeParts[2];\n        }\n    }\n    // Rest of the error string is the error message\n    const errorMessage = parts.join(' ');\n    // Parse error codes to integers safely, defaulting to 0 if NaN\n    const errorCode = parseInt(errorCodeStr);\n    const extErrCode = parseInt(extErrCodeStr);\n    const offsetCode = parseInt(offsetCodeStr);\n    // create an Error object and add the custom properties\n    throw new types_1.SQLiteCloudError(errorMessage, {\n        errorCode: errorCode.toString(),\n        externalErrorCode: extErrCode.toString(),\n        offsetCode\n    });\n}\n/** Parse an array of items (each of which will be parsed by type separately) */\nfunction parseArray(buffer, spaceIndex) {\n    const parsedData = [];\n    const array = buffer.subarray(spaceIndex + 1, buffer.length);\n    const numberOfItems = parseInt(array.subarray(0, spaceIndex - 2).toString('utf8'));\n    let arrayItems = array.subarray(array.indexOf(' ') + 1, array.length);\n    for (let i = 0; i < numberOfItems; i++) {\n        const { data, fwdBuffer: buffer } = popData(arrayItems);\n        parsedData.push(data);\n        arrayItems = buffer;\n    }\n    return parsedData;\n}\n/** Parse header in a rowset or chunk of a chunked rowset */\nfunction parseRowsetHeader(buffer) {\n    const index = parseInt(buffer.subarray(0, buffer.indexOf(':') + 1).toString());\n    buffer = buffer.subarray(buffer.indexOf(':') + 1);\n    // extract rowset header\n    const { data, fwdBuffer } = popIntegers(buffer, 3);\n    const result = {\n        index,\n        metadata: {\n            version: data[0],\n            numberOfRows: data[1],\n            numberOfColumns: data[2],\n            columns: []\n        },\n        fwdBuffer\n    };\n    // console.debug(`parseRowsetHeader`, result)\n    return result;\n}\n/** Extract column names and, optionally, more metadata out of a rowset's header */\nfunction parseRowsetColumnsMetadata(buffer, metadata) {\n    function popForward() {\n        const { data, fwdBuffer: fwdBuffer } = popData(buffer); // buffer in parent scope\n        buffer = fwdBuffer;\n        return data;\n    }\n    for (let i = 0; i < metadata.numberOfColumns; i++) {\n        metadata.columns.push({ name: popForward() });\n    }\n    // extract additional metadata if rowset has version 2\n    if (metadata.version == 2) {\n        for (let i = 0; i < metadata.numberOfColumns; i++)\n            metadata.columns[i].type = popForward();\n        for (let i = 0; i < metadata.numberOfColumns; i++)\n            metadata.columns[i].database = popForward();\n        for (let i = 0; i < metadata.numberOfColumns; i++)\n            metadata.columns[i].table = popForward();\n        for (let i = 0; i < metadata.numberOfColumns; i++)\n            metadata.columns[i].column = popForward(); // original column name\n        for (let i = 0; i < metadata.numberOfColumns; i++)\n            metadata.columns[i].notNull = popForward();\n        for (let i = 0; i < metadata.numberOfColumns; i++)\n            metadata.columns[i].primaryKey = popForward();\n        for (let i = 0; i < metadata.numberOfColumns; i++)\n            metadata.columns[i].autoIncrement = popForward();\n    }\n    return buffer;\n}\n/** Parse a regular rowset (no chunks) */\nfunction parseRowset(buffer, spaceIndex) {\n    buffer = buffer.subarray(spaceIndex + 1, buffer.length);\n    const { metadata, fwdBuffer } = parseRowsetHeader(buffer);\n    buffer = parseRowsetColumnsMetadata(fwdBuffer, metadata);\n    // decode each rowset item\n    const data = [];\n    for (let j = 0; j < metadata.numberOfRows * metadata.numberOfColumns; j++) {\n        const { data: rowData, fwdBuffer } = popData(buffer);\n        data.push(rowData);\n        buffer = fwdBuffer;\n    }\n    console.assert(data && data.length === metadata.numberOfRows * metadata.numberOfColumns, 'SQLiteCloudConnection.parseRowset - invalid rowset data');\n    return new rowset_1.SQLiteCloudRowset(metadata, data);\n}\nfunction bufferStartsWith(buffer, prefix) {\n    return buffer.length >= prefix.length && buffer.subarray(0, prefix.length).toString('utf8') === prefix;\n}\nfunction bufferEndsWith(buffer, suffix) {\n    return buffer.length >= suffix.length && buffer.subarray(buffer.length - suffix.length, buffer.length).toString('utf8') === suffix;\n}\n/**\n * Parse a chunk of a chunked rowset command, eg:\n * *LEN 0:VERS NROWS NCOLS DATA\n * @see https://github.com/sqlitecloud/sdk/blob/master/PROTOCOL.md#scsp-rowset-chunk\n */\nfunction parseRowsetChunks(buffers) {\n    let buffer = Buffer.concat(buffers);\n    if (!bufferStartsWith(buffer, exports.CMD_ROWSET_CHUNK) || !bufferEndsWith(buffer, exports.ROWSET_CHUNKS_END)) {\n        throw new Error('SQLiteCloudConnection.parseRowsetChunks - invalid chunks buffer');\n    }\n    let metadata = { version: 1, numberOfColumns: 0, numberOfRows: 0, columns: [] };\n    const data = [];\n    // validate and skip data type\n    const dataType = buffer.subarray(0, 1).toString();\n    if (dataType !== exports.CMD_ROWSET_CHUNK)\n        throw new Error(`parseRowsetChunks - dataType: ${dataType} should be CMD_ROWSET_CHUNK`);\n    buffer = buffer.subarray(buffer.indexOf(' ') + 1);\n    while (buffer.length > 0 && !bufferStartsWith(buffer, exports.ROWSET_CHUNKS_END)) {\n        // chunk header, eg: 0:VERS NROWS NCOLS\n        const { index: chunkIndex, metadata: chunkMetadata, fwdBuffer } = parseRowsetHeader(buffer);\n        buffer = fwdBuffer;\n        // first chunk? extract columns metadata\n        if (chunkIndex === 1) {\n            metadata = chunkMetadata;\n            buffer = parseRowsetColumnsMetadata(buffer, metadata);\n        }\n        else {\n            metadata.numberOfRows += chunkMetadata.numberOfRows;\n        }\n        // extract single rowset row\n        for (let k = 0; k < chunkMetadata.numberOfRows * metadata.numberOfColumns; k++) {\n            const { data: itemData, fwdBuffer } = popData(buffer);\n            data.push(itemData);\n            buffer = fwdBuffer;\n        }\n    }\n    console.assert(data && data.length === metadata.numberOfRows * metadata.numberOfColumns, 'parseRowsetChunks - invalid rowset data');\n    const rowset = new rowset_1.SQLiteCloudRowset(metadata, data);\n    // console.debug(`parseRowsetChunks - ${rowset.numberOfRows} rows, ${rowset.numberOfColumns} columns`)\n    return rowset;\n}\n/** Pop one or more space separated integers from beginning of buffer, move buffer forward */\nfunction popIntegers(buffer, numberOfIntegers = 1) {\n    const data = [];\n    for (let i = 0; i < numberOfIntegers; i++) {\n        const spaceIndex = buffer.indexOf(' ');\n        data[i] = parseInt(buffer.subarray(0, spaceIndex).toString());\n        buffer = buffer.subarray(spaceIndex + 1);\n    }\n    return { data, fwdBuffer: buffer };\n}\n/** Parse command, extract its data, return the data and the buffer moved to the first byte after the command */\nfunction popData(buffer) {\n    function popResults(data) {\n        const fwdBuffer = buffer.subarray(commandEnd);\n        return { data, fwdBuffer };\n    }\n    // first character is the data type\n    console.assert(buffer && buffer instanceof Buffer);\n    let dataType = buffer.subarray(0, 1).toString('utf8');\n    if (dataType == exports.CMD_COMPRESSED)\n        throw new Error('Compressed data should be decompressed before parsing');\n    if (dataType == exports.CMD_ROWSET_CHUNK)\n        throw new Error('Chunked data should be parsed by parseRowsetChunks');\n    let spaceIndex = buffer.indexOf(' ');\n    if (spaceIndex === -1) {\n        spaceIndex = buffer.length - 1;\n    }\n    let commandEnd = -1, commandLength = -1;\n    if (dataType === exports.CMD_INT || dataType === exports.CMD_FLOAT || dataType === exports.CMD_NULL) {\n        commandEnd = spaceIndex + 1;\n    }\n    else {\n        commandLength = parseInt(buffer.subarray(1, spaceIndex).toString());\n        commandEnd = spaceIndex + 1 + commandLength;\n    }\n    // console.debug(`popData - dataType: ${dataType}, spaceIndex: ${spaceIndex}, commandLength: ${commandLength}, commandEnd: ${commandEnd}`)\n    switch (dataType) {\n        case exports.CMD_INT:\n            // SQLite uses 64-bit INTEGER, but JS uses 53-bit Number\n            const value = BigInt(buffer.subarray(1, spaceIndex).toString());\n            if (types_1.SAFE_INTEGER_MODE === 'bigint') {\n                return popResults(value);\n            }\n            if (types_1.SAFE_INTEGER_MODE === 'mixed') {\n                if (value <= BigInt(Number.MIN_SAFE_INTEGER) || BigInt(Number.MAX_SAFE_INTEGER) <= value) {\n                    return popResults(value);\n                }\n            }\n            return popResults(Number(value));\n        case exports.CMD_FLOAT:\n            return popResults(parseFloat(buffer.subarray(1, spaceIndex).toString()));\n        case exports.CMD_NULL:\n            return popResults(null);\n        case exports.CMD_STRING:\n            return popResults(buffer.subarray(spaceIndex + 1, commandEnd).toString('utf8'));\n        case exports.CMD_ZEROSTRING:\n            return popResults(buffer.subarray(spaceIndex + 1, commandEnd - 1).toString('utf8'));\n        case exports.CMD_COMMAND:\n            return popResults(buffer.subarray(spaceIndex + 1, commandEnd).toString('utf8'));\n        case exports.CMD_PUBSUB:\n            return popResults(buffer.subarray(spaceIndex + 1, commandEnd).toString('utf8'));\n        case exports.CMD_JSON:\n            return popResults(JSON.parse(buffer.subarray(spaceIndex + 1, commandEnd).toString('utf8')));\n        case exports.CMD_BLOB:\n            return popResults(buffer.subarray(spaceIndex + 1, commandEnd));\n        case exports.CMD_ARRAY:\n            return popResults(parseArray(buffer, spaceIndex));\n        case exports.CMD_ROWSET:\n            return popResults(parseRowset(buffer, spaceIndex));\n        case exports.CMD_ERROR:\n            parseError(buffer, spaceIndex); // throws custom error\n            break;\n    }\n    const msg = `popData - Data type: ${Number(dataType)} '${dataType}'  is not defined in SCSP, spaceIndex: ${spaceIndex}, commandLength: ${commandLength}, commandEnd: ${commandEnd}`;\n    console.error(msg);\n    throw new TypeError(msg);\n}\n/** Format a command to be sent via SCSP protocol */\nfunction formatCommand(command) {\n    // core returns null if there's a space after the semi column\n    // we want to maintain a compatibility with the standard sqlite3 driver\n    command.query = command.query.trim();\n    if (command.parameters && command.parameters.length > 0) {\n        // by SCSP the string paramenters in the array are zero-terminated\n        return serializeCommand([command.query, ...(command.parameters || [])], true);\n    }\n    return serializeData(command.query, false);\n}\nfunction serializeCommand(data, zeroString = false) {\n    const n = data.length;\n    let serializedData = Buffer.from(`${n} `);\n    for (let i = 0; i < n; i++) {\n        // the first string is the sql and it must be zero-terminated\n        const zs = i == 0 || zeroString;\n        serializedData = Buffer.concat([serializedData, serializeData(data[i], zs)]);\n    }\n    const bytesTotal = serializedData.byteLength;\n    const header = Buffer.from(`${exports.CMD_ARRAY}${bytesTotal} `);\n    return Buffer.concat([header, serializedData]);\n}\nfunction serializeData(data, zeroString = false) {\n    if (typeof data === 'string') {\n        let cmd = exports.CMD_STRING;\n        if (zeroString) {\n            cmd = exports.CMD_ZEROSTRING;\n            data += '\\0';\n        }\n        const header = `${cmd}${Buffer.byteLength(data, 'utf-8')} `;\n        return Buffer.from(header + data);\n    }\n    if (typeof data === 'number') {\n        if (Number.isInteger(data)) {\n            return Buffer.from(`${exports.CMD_INT}${data} `);\n        }\n        else {\n            return Buffer.from(`${exports.CMD_FLOAT}${data} `);\n        }\n    }\n    if (typeof data === 'bigint') {\n        return Buffer.from(`${exports.CMD_INT}${data} `);\n    }\n    if (Buffer.isBuffer(data)) {\n        const header = `${exports.CMD_BLOB}${data.byteLength} `;\n        return Buffer.concat([Buffer.from(header), data]);\n    }\n    if (data === null || data === undefined) {\n        return Buffer.from(`${exports.CMD_NULL} `);\n    }\n    if (Array.isArray(data)) {\n        return serializeCommand(data, zeroString);\n    }\n    throw new Error(`Unsupported data type for serialization: ${typeof data}`);\n}\n\n\n//# sourceURL=webpack://sqlitecloud/./lib/drivers/protocol.js?");
 
 /***/ }),
 
@@ -107,6 +107,17 @@ eval("\n//\n// rowset.ts\n//\nvar __classPrivateFieldSet = (this && this.__class
 
 /***/ }),
 
+/***/ "./lib/drivers/safe-imports.js":
+/*!*************************************!*\
+  !*** ./lib/drivers/safe-imports.js ***!
+  \*************************************/
+/***/ ((__unused_webpack_module, exports, __webpack_require__) => {
+
+"use strict";
+eval("\n/**\n * safe-imports.ts - Safe imports for optional React Native dependencies\n *\n * This module provides safe imports for dependencies that are optional peer dependencies.\n * When these dependencies are not installed (e.g., using the package in a web/Next.js context),\n * the imports will still work. However, in React Native contexts where these dependencies are\n * required but not installed, clear error messages will be thrown.\n */\nObject.defineProperty(exports, \"__esModule\", ({ value: true }));\nexports.isReactNative = isReactNative;\nexports.getSafeURL = getSafeURL;\nexports.getSafeBuffer = getSafeBuffer;\nexports.getSafeTLS = getSafeTLS;\nconst types_1 = __webpack_require__(/*! ./types */ \"./lib/drivers/types.js\");\n/**\n * Detects if we're running in React Native environment\n */\nfunction isReactNative() {\n    return typeof navigator !== 'undefined' && navigator.product === 'ReactNative';\n}\n/**\n * Safely imports the URL class from whatwg-url or react-native-url-polyfill\n * In React Native: Uses react-native-url-polyfill (via react-native field mapping)\n * In Web/Node: Uses whatwg-url\n */\nfunction getSafeURL() {\n    try {\n        // In React Native, Metro bundler will resolve this to react-native-url-polyfill\n        // In Web/Node, this will resolve to whatwg-url\n        const { URL } = __webpack_require__(/*! whatwg-url */ \"./node_modules/whatwg-url/index.js\");\n        return URL;\n    }\n    catch (error) {\n        if (isReactNative()) {\n            throw new types_1.SQLiteCloudError('Missing required React Native dependency: react-native-url-polyfill. ' +\n                'Please install it using: npm install react-native-url-polyfill', { errorCode: 'ERR_MISSING_DEPENDENCY', cause: error });\n        }\n        throw new types_1.SQLiteCloudError('Failed to load URL parser. Please ensure whatwg-url is installed.', { errorCode: 'ERR_MISSING_DEPENDENCY', cause: error });\n    }\n}\n/**\n * Safely imports the Buffer class from buffer or @craftzdog/react-native-buffer\n * In React Native: Uses @craftzdog/react-native-buffer (via react-native field mapping)\n * In Web/Node: Uses buffer package\n */\nfunction getSafeBuffer() {\n    try {\n        // In React Native, Metro bundler will resolve this to @craftzdog/react-native-buffer\n        // In Web/Node, this will resolve to buffer package\n        const { Buffer } = __webpack_require__(/*! buffer */ \"./node_modules/buffer/index.js\");\n        return Buffer;\n    }\n    catch (error) {\n        if (isReactNative()) {\n            throw new types_1.SQLiteCloudError('Missing required React Native dependency: @craftzdog/react-native-buffer. ' +\n                'Please install it using: npm install @craftzdog/react-native-buffer', { errorCode: 'ERR_MISSING_DEPENDENCY', cause: error });\n        }\n        throw new types_1.SQLiteCloudError('Failed to load Buffer library. Please ensure buffer package is installed.', { errorCode: 'ERR_MISSING_DEPENDENCY', cause: error });\n    }\n}\n/**\n * Safely imports the tls module or react-native-tcp-socket\n * In React Native: Uses react-native-tcp-socket (via react-native field mapping)\n * In Node: Uses native tls module\n * In Browser: Will return null (browser field sets tls to false)\n */\nfunction getSafeTLS() {\n    try {\n        // In React Native, Metro bundler will resolve this to react-native-tcp-socket\n        // In Node, this will resolve to native tls module\n        // In Browser, the browser field in package.json sets tls to false\n        const tls = __webpack_require__(/*! tls */ \"?4235\");\n        if (tls === false || !tls) {\n            return null;\n        }\n        return tls;\n    }\n    catch (error) {\n        if (isReactNative()) {\n            throw new types_1.SQLiteCloudError('Missing required React Native dependency: react-native-tcp-socket. ' +\n                'Please install it using: npm install react-native-tcp-socket', { errorCode: 'ERR_MISSING_DEPENDENCY', cause: error });\n        }\n        // In browser context, tls is not available (WebSocket should be used instead)\n        return null;\n    }\n}\n\n\n//# sourceURL=webpack://sqlitecloud/./lib/drivers/safe-imports.js?");
+
+/***/ }),
+
 /***/ "./lib/drivers/statement.js":
 /*!**********************************!*\
   !*** ./lib/drivers/statement.js ***!
@@ -136,7 +147,7 @@ eval("\n/**\n * types.ts - shared types and interfaces\n */\nvar _a;\nObject.def
 /***/ ((__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.isNode = exports.isBrowser = void 0;\nexports.anonimizeCommand = anonimizeCommand;\nexports.anonimizeError = anonimizeError;\nexports.getInitializationCommands = getInitializationCommands;\nexports.sanitizeSQLiteIdentifier = sanitizeSQLiteIdentifier;\nexports.getUpdateResults = getUpdateResults;\nexports.popCallback = popCallback;\nexports.validateConfiguration = validateConfiguration;\nexports.parseconnectionstring = parseconnectionstring;\nexports.parseBoolean = parseBoolean;\nexports.parseBooleanToZeroOne = parseBooleanToZeroOne;\nconst types_1 = __webpack_require__(/*! ./types */ \"./lib/drivers/types.js\");\n// explicitly importing these libraries to allow cross-platform support by replacing them\nconst whatwg_url_1 = __webpack_require__(/*! whatwg-url */ \"./node_modules/whatwg-url/index.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}\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}\n/** Initialization commands sent to database when connection is established */\nfunction getInitializationCommands(config) {\n    // we check the credentials using non linearizable so we're quicker\n    // then we bring back linearizability unless specified otherwise\n    let commands = 'SET CLIENT KEY NONLINEARIZABLE TO 1;';\n    // first user authentication, then all other commands\n    if (config.apikey) {\n        commands += `AUTH APIKEY ${config.apikey};`;\n    }\n    else if (config.token) {\n        commands += `AUTH TOKEN ${config.token};`;\n    }\n    else {\n        commands += `AUTH USER ${config.username || ''} ${config.password_hashed ? 'HASH' : 'PASSWORD'} ${config.password || ''};`;\n    }\n    if (config.compression) {\n        commands += 'SET CLIENT KEY COMPRESSION TO 1;';\n    }\n    if (config.zerotext) {\n        commands += 'SET CLIENT KEY ZEROTEXT 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    // we ALWAYS set non linearizable to 1 when we start so we can be quicker on login\n    // but then we need to put it back to its default value if \"linearizable\" unless set\n    if (!config.non_linearizable) {\n        commands += 'SET CLIENT KEY NONLINEARIZABLE TO 0;';\n    }\n    if (config.database) {\n        if (config.create && !config.memory) {\n            commands += `CREATE DATABASE ${config.database} IF NOT EXISTS;`;\n        }\n        commands += `USE DATABASE ${config.database};`;\n    }\n    return commands;\n}\n/** Sanitizes an SQLite identifier (e.g., table name, column name). */\nfunction sanitizeSQLiteIdentifier(identifier) {\n    const trimmed = identifier.trim();\n    // it's not empty\n    if (trimmed.length === 0) {\n        throw new Error('Identifier cannot be empty.');\n    }\n    // escape double quotes\n    const escaped = trimmed.replace(/\"/g, '\"\"');\n    // Wrap in double quotes for safety\n    return `\"${escaped}\"`;\n}\n/** Converts results of an update or insert call into a more meaning full result set */\nfunction getUpdateResults(results) {\n    if (results) {\n        if (Array.isArray(results) && results.length > 0) {\n            switch (results[0]) {\n                case types_1.SQLiteCloudArrayType.ARRAY_TYPE_SQLITE_EXEC:\n                    return {\n                        type: Number(results[0]),\n                        index: Number(results[1]),\n                        lastID: results[2], // ROWID (sqlite3_last_insert_rowid)\n                        changes: results[3], // CHANGES(sqlite3_changes)\n                        totalChanges: results[4], // TOTAL_CHANGES (sqlite3_total_changes)\n                        finalized: Number(results[5]), // FINALIZED\n                        rowId: results[2] // same as lastId\n                    };\n            }\n        }\n    }\n    return undefined;\n}\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 *\n * @returns args is a simple list of SQLiteCloudDataTypes, we flat them into a single array\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).flat(), callback: args[args.length - 2], complete: args[args.length - 1] };\n        }\n        return { args: remaining.slice(0, -1).flat(), callback: args[args.length - 1] };\n    }\n    return { args: remaining.flat() };\n}\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 = config.compression != undefined && config.compression != null ? parseBoolean(config.compression) : true; // default: true\n    config.create = parseBoolean(config.create);\n    config.non_linearizable = parseBoolean(config.non_linearizable);\n    config.insecure = parseBoolean(config.insecure);\n    const hasCredentials = (config.username && config.password) || config.apikey || config.token;\n    if (!config.host || !hasCredentials) {\n        console.error('SQLiteCloudConnection.validateConfiguration - missing arguments', config);\n        throw new types_1.SQLiteCloudError('The user, password and host arguments, the ?apikey= or the ?token= must be specified.', { errorCode: 'ERR_MISSING_ARGS' });\n    }\n    if (!config.connectionstring) {\n        // build connection string from configuration, values are already validated\n        config.connectionstring = `sqlitecloud://${config.host}:${config.port}/${config.database || ''}`;\n        if (config.apikey) {\n            config.connectionstring += `?apikey=${config.apikey}`;\n        }\n        else if (config.token) {\n            config.connectionstring += `?token=${config.token}`;\n        }\n        else {\n            config.connectionstring = `sqlitecloud://${encodeURIComponent(config.username || '')}:${encodeURIComponent(config.password || '')}@${config.host}:${config.port}/${config.database}`;\n        }\n    }\n    return config;\n}\n/**\n * Parse connectionstring like sqlitecloud://username:password@host:port/database?option1=xxx&option2=xxx\n * or sqlitecloud://host.sqlite.cloud:8860/chinook.sqlite?apikey=mIiLARzKm9XBVllbAzkB1wqrgijJ3Gx0X5z1Agm3xBo\n * into its basic components.\n */\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 whatwg_url_1.URL(knownProtocolUrl);\n        // all lowecase options\n        const options = {};\n        url.searchParams.forEach((value, key) => {\n            options[key.toLowerCase().replace(/-/g, '_')] = value.trim();\n        });\n        const config = Object.assign(Object.assign({}, options), { username: url.username ? decodeURIComponent(url.username) : undefined, password: url.password ? decodeURIComponent(url.password) : undefined, password_hashed: options.password_hashed ? parseBoolean(options.password_hashed) : undefined, host: url.hostname, \n            // type cast values\n            port: url.port ? parseInt(url.port) : undefined, insecure: options.insecure ? parseBoolean(options.insecure) : undefined, timeout: options.timeout ? parseInt(options.timeout) : undefined, zerotext: options.zerotext ? parseBoolean(options.zerotext) : undefined, create: options.create ? parseBoolean(options.create) : undefined, memory: options.memory ? parseBoolean(options.memory) : undefined, compression: options.compression ? parseBoolean(options.compression) : undefined, non_linearizable: options.non_linearizable ? parseBoolean(options.non_linearizable) : undefined, noblob: options.noblob ? parseBoolean(options.noblob) : undefined, maxdata: options.maxdata ? parseInt(options.maxdata) : undefined, maxrows: options.maxrows ? parseInt(options.maxrows) : undefined, maxrowset: options.maxrowset ? parseInt(options.maxrowset) : undefined, usewebsocket: options.usewebsocket ? parseBoolean(options.usewebsocket) : undefined, verbose: options.verbose ? parseBoolean(options.verbose) : undefined });\n        // either you use an apikey, token or username and password\n        if (Number(!!config.apikey) + Number(!!config.token) + Number(!!(config.username || config.password)) > 1) {\n            console.error('SQLiteCloudConnection.parseconnectionstring - choose between apikey, token or username/password');\n            throw new types_1.SQLiteCloudError('Choose between apikey, token or username/password');\n        }\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} - error: ${error}`);\n    }\n}\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}\n/** Returns true if value is 1 or true */\nfunction parseBooleanToZeroOne(value) {\n    if (typeof value === 'string') {\n        return value.toLowerCase() === 'true' || value === '1' ? 1 : 0;\n    }\n    return value ? 1 : 0;\n}\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.isNode = exports.isBrowser = void 0;\nexports.anonimizeCommand = anonimizeCommand;\nexports.anonimizeError = anonimizeError;\nexports.getInitializationCommands = getInitializationCommands;\nexports.sanitizeSQLiteIdentifier = sanitizeSQLiteIdentifier;\nexports.getUpdateResults = getUpdateResults;\nexports.popCallback = popCallback;\nexports.validateConfiguration = validateConfiguration;\nexports.parseconnectionstring = parseconnectionstring;\nexports.parseBoolean = parseBoolean;\nexports.parseBooleanToZeroOne = parseBooleanToZeroOne;\nconst types_1 = __webpack_require__(/*! ./types */ \"./lib/drivers/types.js\");\nconst safe_imports_1 = __webpack_require__(/*! ./safe-imports */ \"./lib/drivers/safe-imports.js\");\n// explicitly importing these libraries to allow cross-platform support by replacing them\n// In React Native: Metro resolves 'whatwg-url' to 'react-native-url-polyfill' via package.json react-native field\n// In Web/Node: Uses standard whatwg-url package\nconst URL = (0, safe_imports_1.getSafeURL)();\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}\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}\n/** Initialization commands sent to database when connection is established */\nfunction getInitializationCommands(config) {\n    // we check the credentials using non linearizable so we're quicker\n    // then we bring back linearizability unless specified otherwise\n    let commands = 'SET CLIENT KEY NONLINEARIZABLE TO 1;';\n    // first user authentication, then all other commands\n    if (config.apikey) {\n        commands += `AUTH APIKEY ${config.apikey};`;\n    }\n    else if (config.token) {\n        commands += `AUTH TOKEN ${config.token};`;\n    }\n    else {\n        commands += `AUTH USER ${config.username || ''} ${config.password_hashed ? 'HASH' : 'PASSWORD'} ${config.password || ''};`;\n    }\n    if (config.compression) {\n        commands += 'SET CLIENT KEY COMPRESSION TO 1;';\n    }\n    if (config.zerotext) {\n        commands += 'SET CLIENT KEY ZEROTEXT 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    // we ALWAYS set non linearizable to 1 when we start so we can be quicker on login\n    // but then we need to put it back to its default value if \"linearizable\" unless set\n    if (!config.non_linearizable) {\n        commands += 'SET CLIENT KEY NONLINEARIZABLE TO 0;';\n    }\n    if (config.database) {\n        if (config.create && !config.memory) {\n            commands += `CREATE DATABASE ${config.database} IF NOT EXISTS;`;\n        }\n        commands += `USE DATABASE ${config.database};`;\n    }\n    return commands;\n}\n/** Sanitizes an SQLite identifier (e.g., table name, column name). */\nfunction sanitizeSQLiteIdentifier(identifier) {\n    const trimmed = identifier.trim();\n    // it's not empty\n    if (trimmed.length === 0) {\n        throw new Error('Identifier cannot be empty.');\n    }\n    // escape double quotes\n    const escaped = trimmed.replace(/\"/g, '\"\"');\n    // Wrap in double quotes for safety\n    return `\"${escaped}\"`;\n}\n/** Converts results of an update or insert call into a more meaning full result set */\nfunction getUpdateResults(results) {\n    if (results) {\n        if (Array.isArray(results) && results.length > 0) {\n            switch (results[0]) {\n                case types_1.SQLiteCloudArrayType.ARRAY_TYPE_SQLITE_EXEC:\n                    return {\n                        type: Number(results[0]),\n                        index: Number(results[1]),\n                        lastID: results[2], // ROWID (sqlite3_last_insert_rowid)\n                        changes: results[3], // CHANGES(sqlite3_changes)\n                        totalChanges: results[4], // TOTAL_CHANGES (sqlite3_total_changes)\n                        finalized: Number(results[5]), // FINALIZED\n                        rowId: results[2] // same as lastId\n                    };\n            }\n        }\n    }\n    return undefined;\n}\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 *\n * @returns args is a simple list of SQLiteCloudDataTypes, we flat them into a single array\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).flat(), callback: args[args.length - 2], complete: args[args.length - 1] };\n        }\n        return { args: remaining.slice(0, -1).flat(), callback: args[args.length - 1] };\n    }\n    return { args: remaining.flat() };\n}\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 = config.compression != undefined && config.compression != null ? parseBoolean(config.compression) : true; // default: true\n    config.create = parseBoolean(config.create);\n    config.non_linearizable = parseBoolean(config.non_linearizable);\n    config.insecure = parseBoolean(config.insecure);\n    const hasCredentials = (config.username && config.password) || config.apikey || config.token;\n    if (!config.host || !hasCredentials) {\n        console.error('SQLiteCloudConnection.validateConfiguration - missing arguments', config);\n        throw new types_1.SQLiteCloudError('The user, password and host arguments, the ?apikey= or the ?token= must be specified.', { errorCode: 'ERR_MISSING_ARGS' });\n    }\n    if (!config.connectionstring) {\n        // build connection string from configuration, values are already validated\n        config.connectionstring = `sqlitecloud://${config.host}:${config.port}/${config.database || ''}`;\n        if (config.apikey) {\n            config.connectionstring += `?apikey=${config.apikey}`;\n        }\n        else if (config.token) {\n            config.connectionstring += `?token=${config.token}`;\n        }\n        else {\n            config.connectionstring = `sqlitecloud://${encodeURIComponent(config.username || '')}:${encodeURIComponent(config.password || '')}@${config.host}:${config.port}/${config.database}`;\n        }\n    }\n    return config;\n}\n/**\n * Parse connectionstring like sqlitecloud://username:password@host:port/database?option1=xxx&option2=xxx\n * or sqlitecloud://host.sqlite.cloud:8860/chinook.sqlite?apikey=mIiLARzKm9XBVllbAzkB1wqrgijJ3Gx0X5z1Agm3xBo\n * into its basic components.\n */\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        // all lowecase options\n        const options = {};\n        url.searchParams.forEach((value, key) => {\n            options[key.toLowerCase().replace(/-/g, '_')] = value.trim();\n        });\n        const config = Object.assign(Object.assign({}, options), { username: url.username ? decodeURIComponent(url.username) : undefined, password: url.password ? decodeURIComponent(url.password) : undefined, password_hashed: options.password_hashed ? parseBoolean(options.password_hashed) : undefined, host: url.hostname, \n            // type cast values\n            port: url.port ? parseInt(url.port) : undefined, insecure: options.insecure ? parseBoolean(options.insecure) : undefined, timeout: options.timeout ? parseInt(options.timeout) : undefined, zerotext: options.zerotext ? parseBoolean(options.zerotext) : undefined, create: options.create ? parseBoolean(options.create) : undefined, memory: options.memory ? parseBoolean(options.memory) : undefined, compression: options.compression ? parseBoolean(options.compression) : undefined, non_linearizable: options.non_linearizable ? parseBoolean(options.non_linearizable) : undefined, noblob: options.noblob ? parseBoolean(options.noblob) : undefined, maxdata: options.maxdata ? parseInt(options.maxdata) : undefined, maxrows: options.maxrows ? parseInt(options.maxrows) : undefined, maxrowset: options.maxrowset ? parseInt(options.maxrowset) : undefined, usewebsocket: options.usewebsocket ? parseBoolean(options.usewebsocket) : undefined, verbose: options.verbose ? parseBoolean(options.verbose) : undefined });\n        // either you use an apikey, token or username and password\n        if (Number(!!config.apikey) + Number(!!config.token) + Number(!!(config.username || config.password)) > 1) {\n            console.error('SQLiteCloudConnection.parseconnectionstring - choose between apikey, token or username/password');\n            throw new types_1.SQLiteCloudError('Choose between apikey, token or username/password');\n        }\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} - error: ${error}`);\n    }\n}\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}\n/** Returns true if value is 1 or true */\nfunction parseBooleanToZeroOne(value) {\n    if (typeof value === 'string') {\n        return value.toLowerCase() === 'true' || value === '1' ? 1 : 0;\n    }\n    return value ? 1 : 0;\n}\n\n\n//# sourceURL=webpack://sqlitecloud/./lib/drivers/utilities.js?");
 
 /***/ }),