@sqlitecloud/drivers 1.0.276 → 1.0.345

package/README.md

@@ -1,7 +1,7 @@
 # @sqlitecloud/drivers
 
 [![npm package][npm-img]][npm-url]
-[![Build Status][build-img]][build-url]
+[![Test][test-img]][test-url]
 [![Downloads][downloads-img]][downloads-url]
 [![Issues][issues-img]][issues-url]
 [![codecov](https://codecov.io/gh/sqlitecloud/sqlitecloud-js/graph/badge.svg?token=ZOKE9WFH62)](https://codecov.io/gh/sqlitecloud/sqlitecloud-js)
@@ -107,8 +107,8 @@ How do I connect SQLite cloud with Javascript?
 How can I contribute or suggest features?  
 [https://github.com/sqlitecloud/sqlitecloud-js/issues](https://github.com/sqlitecloud/sqlitecloud-js/issues)
 
-[build-img]: https://github.com/sqlitecloud/sqlitecloud-js/actions/workflows/build-test-deploy.yml/badge.svg
-[build-url]: https://github.com/sqlitecloud/sqlitecloud-js/actions/workflows/build-test-deploy.yml
+[test-img]: https://img.shields.io/github/actions/workflow/status/sqlitecloud/sqlitecloud-js/test.yml?label=Android%20%7C%20iOS%20%7C%20Web%20%7C%20Windows%20%7C%20MacOS%20%7C%20Linux
+[test-url]: https://github.com/sqlitecloud/sqlitecloud-js/actions/workflows/test.yml
 [downloads-img]: https://img.shields.io/npm/dt/@sqlitecloud/drivers
 [downloads-url]: https://www.npmtrends.com/@sqlitecloud/drivers
 [npm-img]: https://img.shields.io/npm/v/@sqlitecloud/drivers

package/lib/drivers/connection-tls.d.ts

@@ -1,7 +1,7 @@
 /**
  * connection-tls.ts - connection via tls socket and sqlitecloud protocol
  */
-import { type SQLiteCloudConfig, type ErrorCallback, type ResultsCallback } from './types';
+import { type SQLiteCloudConfig, type ErrorCallback, type ResultsCallback, SQLiteCloudCommand } from './types';
 import { SQLiteCloudConnection } from './connection';
 /**
  * Implementation of SQLiteCloudConnection that connects to the database using specific tls APIs
@@ -14,7 +14,7 @@ export declare class SQLiteCloudTlsConnection extends SQLiteCloudConnection {
     get connected(): boolean;
     connectTransport(config: SQLiteCloudConfig, callback?: ErrorCallback): this;
     /** Will send a command immediately (no queueing), return the rowset/result or throw an error */
-    transportCommands(commands: string, callback?: ResultsCallback): this;
+    transportCommands(commands: string | SQLiteCloudCommand, callback?: ResultsCallback): this;
     private buffer;
     private startedOn;
     private executingCommands?;

package/lib/drivers/connection-tls.js

@@ -18,13 +18,23 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SQLiteCloudTlsConnection = void 0;
 const types_1 = require("./types");
@@ -54,7 +64,6 @@ class SQLiteCloudTlsConnection extends connection_1.SQLiteCloudConnection {
         return !!this.socket;
     }
     /* Opens a connection with the server and sends the initialization commands. Will throw in case of errors. */
-    /* eslint-disable @typescript-eslint/no-unused-vars */
     connectTransport(config, callback) {
         console.assert(!this.connected, 'SQLiteCloudTlsConnection.connect - connection already established');
         if (this.config.verbose) {
@@ -118,6 +127,9 @@ class SQLiteCloudTlsConnection extends connection_1.SQLiteCloudConnection {
             callback === null || callback === void 0 ? void 0 : callback.call(this, new types_1.SQLiteCloudError('Connection not established', { errorCode: 'ERR_CONNECTION_NOT_ESTABLISHED' }));
             return this;
         }
+        if (typeof commands === 'string') {
+            commands = { query: commands };
+        }
         // reset buffer and rowset chunks, define response callback
         this.buffer = buffer_1.Buffer.alloc(0);
         this.startedOn = new Date();

package/lib/drivers/connection-ws.d.ts

@@ -1,7 +1,7 @@
 /**
  * transport-ws.ts - handles low level communication with sqlitecloud server via socket.io websocket
  */
-import { SQLiteCloudConfig, ErrorCallback, ResultsCallback } from './types';
+import { SQLiteCloudConfig, ErrorCallback, ResultsCallback, SQLiteCloudCommand } from './types';
 import { SQLiteCloudConnection } from './connection';
 /**
  * Implementation of TransportConnection that connects to the database indirectly
@@ -16,7 +16,7 @@ export declare class SQLiteCloudWebsocketConnection extends SQLiteCloudConnectio
     get connected(): boolean;
     connectTransport(config: SQLiteCloudConfig, callback?: ErrorCallback): this;
     /** Will send a command immediately (no queueing), return the rowset/result or throw an error */
-    transportCommands(commands: string, callback?: ResultsCallback): this;
+    transportCommands(commands: string | SQLiteCloudCommand, callback?: ResultsCallback): this;
     /** Disconnect socket.io from server */
     close(): this;
 }

package/lib/drivers/connection-ws.js

@@ -45,7 +45,10 @@ class SQLiteCloudWebsocketConnection extends connection_1.SQLiteCloudConnection
             callback === null || callback === void 0 ? void 0 : callback.call(this, new types_1.SQLiteCloudError('Connection not established', { errorCode: 'ERR_CONNECTION_NOT_ESTABLISHED' }));
             return this;
         }
-        this.socket.emit('v1/sql', { sql: commands, row: 'array' }, (response) => {
+        if (typeof commands === 'string') {
+            commands = { query: commands };
+        }
+        this.socket.emit('GET /v2/weblite/sql', { sql: commands.query, bind: commands.parameters, row: 'array' }, (response) => {
             if (response === null || response === void 0 ? void 0 : response.error) {
                 const error = new types_1.SQLiteCloudError(response.error.detail, Object.assign({}, response.error));
                 callback === null || callback === void 0 ? void 0 : callback.call(this, error);
@@ -56,7 +59,6 @@ class SQLiteCloudWebsocketConnection extends connection_1.SQLiteCloudConnection
                     if (metadata.numberOfRows !== undefined && metadata.numberOfColumns !== undefined && metadata.columns !== undefined) {
                         console.assert(Array.isArray(data), 'SQLiteCloudWebsocketConnection.transportCommands - data is not an array');
                         // we can recreate a SQLiteCloudRowset from the response which we know to be an array of arrays
-                        // eslint-disable-next-line @typescript-eslint/no-unsafe-call
                         const rowset = new rowset_1.SQLiteCloudRowset(metadata, data.flat());
                         callback === null || callback === void 0 ? void 0 : callback.call(this, null, rowset);
                         return;

package/lib/drivers/connection.d.ts

@@ -1,7 +1,7 @@
 /**
  * connection.ts - base abstract class for sqlitecloud server connections
  */
-import { SQLiteCloudConfig, ErrorCallback, ResultsCallback } from './types';
+import { SQLiteCloudConfig, ErrorCallback, ResultsCallback, SQLiteCloudCommand } from './types';
 import { OperationsQueue } from './queue';
 /**
  * Base class for SQLiteCloudConnection handles basics and defines methods.
@@ -20,7 +20,7 @@ export declare abstract class SQLiteCloudConnection {
     protected connect(callback?: ErrorCallback): this;
     protected abstract connectTransport(config: SQLiteCloudConfig, callback?: ErrorCallback): this;
     /** Send a command, return the rowset/result or throw an error */
-    protected abstract transportCommands(commands: string, callback?: ResultsCallback): this;
+    protected abstract transportCommands(commands: string | SQLiteCloudCommand, callback?: ResultsCallback): this;
     /** Will log to console if verbose mode is enabled */
     protected log(message: string, ...optionalParams: any[]): void;
     /** Returns true if connection is open */
@@ -28,17 +28,18 @@ export declare abstract class SQLiteCloudConnection {
     /** Enable verbose logging for debug purposes */
     verbose(): void;
     /** Will enquee a command to be executed and callback with the resulting rowset/result/error */
-    sendCommands(commands: string, callback?: ResultsCallback): this;
+    sendCommands(commands: string | SQLiteCloudCommand, callback?: ResultsCallback): this;
     /**
      * Sql is a promise based API for executing SQL statements. You can
      * pass a simple string with a SQL statement or a template string
      * using backticks and parameters in ${parameter} format. These parameters
      * will be properly escaped and quoted like when using a prepared statement.
      * @param sql A sql string or a template string in `backticks` format
+     *  A SQLiteCloudCommand when the query is defined with question marks and bindings.
      * @returns An array of rows in case of selections or an object with
      * metadata in case of insert, update, delete.
      */
-    sql(sql: TemplateStringsArray | string, ...values: any[]): Promise<any>;
+    sql(sql: TemplateStringsArray | string | SQLiteCloudCommand, ...values: any[]): Promise<any>;
     /** Disconnect from server, release transport. */
     abstract close(): this;
 }

package/lib/drivers/connection.js

@@ -92,34 +92,35 @@ class SQLiteCloudConnection {
      * using backticks and parameters in ${parameter} format. These parameters
      * will be properly escaped and quoted like when using a prepared statement.
      * @param sql A sql string or a template string in `backticks` format
+     *  A SQLiteCloudCommand when the query is defined with question marks and bindings.
      * @returns An array of rows in case of selections or an object with
      * metadata in case of insert, update, delete.
      */
     sql(sql, ...values) {
         return __awaiter(this, void 0, void 0, function* () {
-            let preparedSql = '';
+            let commands = { query: '' };
             // sql is a TemplateStringsArray, the 'raw' property is specific to TemplateStringsArray
             if (Array.isArray(sql) && 'raw' in sql) {
+                let query = '';
                 sql.forEach((string, i) => {
-                    preparedSql += string + (i < values.length ? '?' : '');
+                    // TemplateStringsArray splits the string before each variable
+                    // used in the template. Add the question mark
+                    // to the end of the string for the number of used variables.
+                    query += string + (i < values.length ? '?' : '');
                 });
-                preparedSql = (0, utilities_1.prepareSql)(preparedSql, ...values);
+                commands = { query, parameters: values };
+            }
+            else if (typeof sql === 'string') {
+                commands = { query: sql, parameters: values };
+            }
+            else if (typeof sql === 'object') {
+                commands = sql;
             }
             else {
-                if (typeof sql === 'string') {
-                    if ((values === null || values === void 0 ? void 0 : values.length) > 0) {
-                        preparedSql = (0, utilities_1.prepareSql)(sql, ...values);
-                    }
-                    else {
-                        preparedSql = sql;
-                    }
-                }
-                else {
-                    throw new Error('Invalid sql');
-                }
+                throw new Error('Invalid sql');
             }
             return new Promise((resolve, reject) => {
-                this.sendCommands(preparedSql, (error, results) => {
+                this.sendCommands(commands, (error, results) => {
                     if (error) {
                         reject(error);
                     }

package/lib/drivers/database.d.ts

@@ -1,8 +1,8 @@
-import { SQLiteCloudConfig, RowCountCallback } from './types';
-import { Statement } from './statement';
+import { SQLiteCloudConfig, RowCountCallback, SQLiteCloudCommand } from './types';
 import { ErrorCallback, ResultsCallback, RowCallback, RowsCallback } from './types';
 import EventEmitter from 'eventemitter3';
 import { PubSub } from './pubsub';
+import { Statement } from './statement';
 /**
  * Creating a Database object automatically opens a connection to the SQLite database.
  * When the connection is established the Database object emits an open event and calls
@@ -151,7 +151,7 @@ export declare class Database extends EventEmitter {
      * @returns An array of rows in case of selections or an object with
      * metadata in case of insert, update, delete.
      */
-    sql(sql: TemplateStringsArray | string, ...values: any[]): Promise<any>;
+    sql(sql: TemplateStringsArray | string | SQLiteCloudCommand, ...values: any[]): Promise<any>;
     /**
      * PubSub class provides a Pub/Sub real-time updates and notifications system to
      * allow multiple applications to communicate with each other asynchronously.

package/lib/drivers/database.js

@@ -18,13 +18,23 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
     return new (P || (P = Promise))(function (resolve, reject) {
@@ -42,10 +52,10 @@ exports.Database = void 0;
 const rowset_1 = require("./rowset");
 const types_1 = require("./types");
 const utilities_1 = require("./utilities");
-const statement_1 = require("./statement");
 const eventemitter3_1 = __importDefault(require("eventemitter3"));
 const utilities_2 = require("./utilities");
 const pubsub_1 = require("./pubsub");
+const statement_1 = require("./statement");
 // Uses eventemitter3 instead of node events for browser compatibility
 // https://github.com/primus/eventemitter3
 /**
@@ -155,9 +165,9 @@ class Database extends eventemitter3_1.default {
                 switch (results[0]) {
                     case types_1.SQLiteCloudArrayType.ARRAY_TYPE_SQLITE_EXEC:
                         return {
-                            lastID: results[2],
-                            changes: results[3],
-                            totalChanges: results[4],
+                            lastID: results[2], // ROWID (sqlite3_last_insert_rowid)
+                            changes: results[3], // CHANGES(sqlite3_changes)
+                            totalChanges: results[4], // TOTAL_CHANGES (sqlite3_total_changes)
                             finalized: results[5] // FINALIZED
                         };
                 }
@@ -198,13 +208,13 @@ class Database extends eventemitter3_1.default {
     }
     run(sql, ...params) {
         const { args, callback } = (0, utilities_1.popCallback)(params);
-        const preparedSql = (args === null || args === void 0 ? void 0 : args.length) > 0 ? (0, utilities_1.prepareSql)(sql, ...args) : sql;
+        const command = { query: sql, parameters: args };
         this.getConnection((error, connection) => {
             if (error || !connection) {
                 this.handleError(null, error, callback);
             }
             else {
-                connection.sendCommands(preparedSql, (error, results) => {
+                connection.sendCommands(command, (error, results) => {
                     if (error) {
                         this.handleError(connection, error, callback);
                     }
@@ -220,13 +230,13 @@ class Database extends eventemitter3_1.default {
     }
     get(sql, ...params) {
         const { args, callback } = (0, utilities_1.popCallback)(params);
-        const preparedSql = (args === null || args === void 0 ? void 0 : args.length) > 0 ? (0, utilities_1.prepareSql)(sql, ...args) : sql;
+        const command = { query: sql, parameters: args };
         this.getConnection((error, connection) => {
             if (error || !connection) {
                 this.handleError(null, error, callback);
             }
             else {
-                connection.sendCommands(preparedSql, (error, results) => {
+                connection.sendCommands(command, (error, results) => {
                     if (error) {
                         this.handleError(connection, error, callback);
                     }
@@ -245,13 +255,13 @@ class Database extends eventemitter3_1.default {
     }
     all(sql, ...params) {
         const { args, callback } = (0, utilities_1.popCallback)(params);
-        const preparedSql = (args === null || args === void 0 ? void 0 : args.length) > 0 ? (0, utilities_1.prepareSql)(sql, ...args) : sql;
+        const command = { query: sql, parameters: args };
         this.getConnection((error, connection) => {
             if (error || !connection) {
                 this.handleError(null, error, callback);
             }
             else {
-                connection.sendCommands(preparedSql, (error, results) => {
+                connection.sendCommands(command, (error, results) => {
                     if (error) {
                         this.handleError(connection, error, callback);
                     }
@@ -271,13 +281,13 @@ class Database extends eventemitter3_1.default {
     each(sql, ...params) {
         // extract optional parameters and one or two callbacks
         const { args, callback, complete } = (0, utilities_1.popCallback)(params);
-        const preparedSql = (args === null || args === void 0 ? void 0 : args.length) > 0 ? (0, utilities_1.prepareSql)(sql, ...args) : sql;
+        const command = { query: sql, parameters: args };
         this.getConnection((error, connection) => {
             if (error || !connection) {
                 this.handleError(null, error, callback);
             }
             else {
-                connection.sendCommands(preparedSql, (error, rowset) => {
+                connection.sendCommands(command, (error, rowset) => {
                     if (error) {
                         this.handleError(connection, error, callback);
                     }
@@ -310,8 +320,7 @@ class Database extends eventemitter3_1.default {
      * they are bound to the prepared statement before calling the callback.
      */
     prepare(sql, ...params) {
-        const { args, callback } = (0, utilities_1.popCallback)(params);
-        return new statement_1.Statement(this, sql, ...args, callback);
+        return new statement_1.Statement(this, sql, ...params);
     }
     /**
      * Runs all SQL queries in the supplied string. No result rows are retrieved.
@@ -402,26 +411,26 @@ class Database extends eventemitter3_1.default {
      */
     sql(sql, ...values) {
         return __awaiter(this, void 0, void 0, function* () {
-            let preparedSql = '';
+            let commands = { query: '' };
             // sql is a TemplateStringsArray, the 'raw' property is specific to TemplateStringsArray
             if (Array.isArray(sql) && 'raw' in sql) {
+                let query = '';
                 sql.forEach((string, i) => {
-                    preparedSql += string + (i < values.length ? '?' : '');
+                    // TemplateStringsArray splits the string before each variable
+                    // used in the template. Add the question mark
+                    // to the end of the string for the number of used variables.
+                    query += string + (i < values.length ? '?' : '');
                 });
-                preparedSql = (0, utilities_1.prepareSql)(preparedSql, ...values);
+                commands = { query, parameters: values };
+            }
+            else if (typeof sql === 'string') {
+                commands = { query: sql, parameters: values };
+            }
+            else if (typeof sql === 'object') {
+                commands = sql;
             }
             else {
-                if (typeof sql === 'string') {
-                    if ((values === null || values === void 0 ? void 0 : values.length) > 0) {
-                        preparedSql = (0, utilities_1.prepareSql)(sql, ...values);
-                    }
-                    else {
-                        preparedSql = sql;
-                    }
-                }
-                else {
-                    throw new Error('Invalid sql');
-                }
+                throw new Error('Invalid sql');
             }
             return new Promise((resolve, reject) => {
                 this.getConnection((error, connection) => {
@@ -429,7 +438,7 @@ class Database extends eventemitter3_1.default {
                         reject(error);
                     }
                     else {
-                        connection.sendCommands(preparedSql, (error, results) => {
+                        connection.sendCommands(commands, (error, results) => {
                             if (error) {
                                 reject(error);
                             }

package/lib/drivers/protocol.d.ts

@@ -1,6 +1,6 @@
-/// <reference types="node" />
-import { type SQLCloudRowsetMetadata, type SQLiteCloudDataTypes } from './types';
+import { SQLiteCloudCommand, type SQLCloudRowsetMetadata, type SQLiteCloudDataTypes } from './types';
 import { SQLiteCloudRowset } from './rowset';
+import { Buffer } from 'buffer';
 export declare const CMD_STRING = "+";
 export declare const CMD_ZEROSTRING = "!";
 export declare const CMD_ERROR = "-";
@@ -50,4 +50,4 @@ export declare function popData(buffer: Buffer): {
     fwdBuffer: Buffer;
 };
 /** Format a command to be sent via SCSP protocol */
-export declare function formatCommand(command: string): string;
+export declare function formatCommand(command: SQLiteCloudCommand): string;

package/lib/drivers/protocol.js

@@ -3,7 +3,18 @@
 // protocol.ts - low level protocol handling for SQLiteCloud transport
 //
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.formatCommand = exports.popData = exports.parseRowsetChunks = exports.bufferEndsWith = exports.bufferStartsWith = exports.parseRowsetHeader = exports.parseArray = exports.parseError = exports.decompressBuffer = exports.parseCommandLength = exports.hasCommandLength = exports.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;
+exports.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;
+exports.hasCommandLength = hasCommandLength;
+exports.parseCommandLength = parseCommandLength;
+exports.decompressBuffer = decompressBuffer;
+exports.parseError = parseError;
+exports.parseArray = parseArray;
+exports.parseRowsetHeader = parseRowsetHeader;
+exports.bufferStartsWith = bufferStartsWith;
+exports.bufferEndsWith = bufferEndsWith;
+exports.parseRowsetChunks = parseRowsetChunks;
+exports.popData = popData;
+exports.formatCommand = formatCommand;
 const types_1 = require("./types");
 const rowset_1 = require("./rowset");
 // explicitly importing buffer library to allow cross-platform support by replacing it
@@ -39,12 +50,10 @@ exports.ROWSET_CHUNKS_END = '/6 0 0 0 ';
 function hasCommandLength(firstCharacter) {
     return firstCharacter == exports.CMD_INT || firstCharacter == exports.CMD_FLOAT || firstCharacter == exports.CMD_NULL ? false : true;
 }
-exports.hasCommandLength = hasCommandLength;
 /** Analyze a command with explict LEN and extract it */
 function parseCommandLength(data) {
     return parseInt(data.subarray(1, data.indexOf(' ')).toString('utf8'));
 }
-exports.parseCommandLength = parseCommandLength;
 /** Receive a compressed buffer, decompress with lz4, return buffer and datatype */
 function decompressBuffer(buffer) {
     // https://github.com/sqlitecloud/sdk/blob/master/PROTOCOL.md#scsp-compression
@@ -64,7 +73,6 @@ function decompressBuffer(buffer) {
     let decompressedBuffer = buffer_1.Buffer.alloc(decompressedSize);
     const compressedBuffer = commandBuffer.subarray(commandBuffer.length - compressedSize);
     // lz4js library is javascript and doesn't have types so we silence the type check
-    // eslint-disable-next-line
     const decompressionResult = lz4.decompressBlock(compressedBuffer, decompressedBuffer, 0, compressedSize, 0);
     // the entire command is composed of the header (which is not compressed) + the decompressed block
     decompressedBuffer = buffer_1.Buffer.concat([commandBuffer.subarray(0, commandBuffer.length - compressedSize), decompressedBuffer]);
@@ -73,7 +81,6 @@ function decompressBuffer(buffer) {
     }
     return { buffer: decompressedBuffer, dataType, remainingBuffer };
 }
-exports.decompressBuffer = decompressBuffer;
 /** Parse error message or extended error message */
 function parseError(buffer, spaceIndex) {
     const errorBuffer = buffer.subarray(spaceIndex + 1);
@@ -104,7 +111,6 @@ function parseError(buffer, spaceIndex) {
         offsetCode
     });
 }
-exports.parseError = parseError;
 /** Parse an array of items (each of which will be parsed by type separately) */
 function parseArray(buffer, spaceIndex) {
     const parsedData = [];
@@ -118,7 +124,6 @@ function parseArray(buffer, spaceIndex) {
     }
     return parsedData;
 }
-exports.parseArray = parseArray;
 /** Parse header in a rowset or chunk of a chunked rowset */
 function parseRowsetHeader(buffer) {
     const index = parseInt(buffer.subarray(0, buffer.indexOf(':') + 1).toString());
@@ -138,7 +143,6 @@ function parseRowsetHeader(buffer) {
     // console.debug(`parseRowsetHeader`, result)
     return result;
 }
-exports.parseRowsetHeader = parseRowsetHeader;
 /** Extract column names and, optionally, more metadata out of a rowset's header */
 function parseRowsetColumnsMetadata(buffer, metadata) {
     function popForward() {
@@ -186,11 +190,9 @@ function parseRowset(buffer, spaceIndex) {
 function bufferStartsWith(buffer, prefix) {
     return buffer.length >= prefix.length && buffer.subarray(0, prefix.length).toString('utf8') === prefix;
 }
-exports.bufferStartsWith = bufferStartsWith;
 function bufferEndsWith(buffer, suffix) {
     return buffer.length >= suffix.length && buffer.subarray(buffer.length - suffix.length, buffer.length).toString('utf8') === suffix;
 }
-exports.bufferEndsWith = bufferEndsWith;
 /**
  * Parse a chunk of a chunked rowset command, eg:
  * *LEN 0:VERS NROWS NCOLS DATA
@@ -232,7 +234,6 @@ function parseRowsetChunks(buffers) {
     // console.debug(`parseRowsetChunks - ${rowset.numberOfRows} rows, ${rowset.numberOfColumns} columns`)
     return rowset;
 }
-exports.parseRowsetChunks = parseRowsetChunks;
 /** Pop one or more space separated integers from beginning of buffer, move buffer forward */
 function popIntegers(buffer, numberOfIntegers = 1) {
     const data = [];
@@ -300,10 +301,52 @@ function popData(buffer) {
     console.error(msg);
     throw new TypeError(msg);
 }
-exports.popData = popData;
 /** Format a command to be sent via SCSP protocol */
 function formatCommand(command) {
-    const commandLength = buffer_1.Buffer.byteLength(command, 'utf-8');
-    return `+${commandLength} ${command}`;
+    if (command.parameters && command.parameters.length > 0) {
+        // by SCSP the string paramenters in the array are zero-terminated
+        return serializeCommand([command.query, ...(command.parameters || [])], true);
+    }
+    return serializeData(command.query, false);
+}
+function serializeCommand(data, zeroString = false) {
+    const n = data.length;
+    let serializedData = `${n} `;
+    for (let i = 0; i < n; i++) {
+        // the first string is the sql and it must be zero-terminated
+        const zs = i == 0 || zeroString;
+        serializedData += serializeData(data[i], zs);
+    }
+    const header = `${exports.CMD_ARRAY}${serializedData.length} `;
+    return header + serializedData;
+}
+function serializeData(data, zeroString = false) {
+    if (typeof data === 'string') {
+        let cmd = exports.CMD_STRING;
+        if (zeroString) {
+            cmd = exports.CMD_ZEROSTRING;
+            data += '\0';
+        }
+        const header = `${cmd}${buffer_1.Buffer.byteLength(data, 'utf-8')} `;
+        return header + data;
+    }
+    if (typeof data === 'number') {
+        if (Number.isInteger(data)) {
+            return `${exports.CMD_INT}${data} `;
+        }
+        else {
+            return `${exports.CMD_FLOAT}${data} `;
+        }
+    }
+    if (buffer_1.Buffer.isBuffer(data)) {
+        const header = `${exports.CMD_BLOB}${data.length} `;
+        return header + data.toString('utf-8');
+    }
+    if (data === null || data === undefined) {
+        return `${exports.CMD_NULL} `;
+    }
+    if (Array.isArray(data)) {
+        return serializeCommand(data, zeroString);
+    }
+    throw new Error(`Unsupported data type for serialization: ${typeof data}`);
 }
-exports.formatCommand = formatCommand;

package/lib/drivers/pubsub.d.ts

@@ -31,6 +31,11 @@ export declare class PubSub {
      * @param failIfExists Raise an error if the channel already exists
      */
     createChannel(name: string, failIfExists?: boolean): Promise<any>;
+    /**
+     * Deletes a Pub/Sub channel.
+     * @param name Channel name
+     */
+    removeChannel(name: string): Promise<any>;
     /**
      * Send a message to the channel.
      */

package/lib/drivers/pubsub.js

@@ -18,7 +18,7 @@ var PUBSUB_ENTITY_TYPE;
 (function (PUBSUB_ENTITY_TYPE) {
     PUBSUB_ENTITY_TYPE["TABLE"] = "TABLE";
     PUBSUB_ENTITY_TYPE["CHANNEL"] = "CHANNEL";
-})(PUBSUB_ENTITY_TYPE = exports.PUBSUB_ENTITY_TYPE || (exports.PUBSUB_ENTITY_TYPE = {}));
+})(PUBSUB_ENTITY_TYPE || (exports.PUBSUB_ENTITY_TYPE = PUBSUB_ENTITY_TYPE = {}));
 /**
  * Pub/Sub class to receive changes on database tables or to send messages to channels.
  */
@@ -71,13 +71,22 @@ class PubSub {
      * @param name Channel name
      * @param failIfExists Raise an error if the channel already exists
      */
-    createChannel(name, failIfExists = true) {
-        return __awaiter(this, void 0, void 0, function* () {
+    createChannel(name_1) {
+        return __awaiter(this, arguments, void 0, function* (name, failIfExists = true) {
             let notExistsCommand = '';
             if (!failIfExists) {
-                notExistsCommand = 'IF NOT EXISTS;';
+                notExistsCommand = ' IF NOT EXISTS';
             }
-            return this.connection.sql(`CREATE CHANNEL ? ${notExistsCommand}`, name);
+            return this.connection.sql(`CREATE CHANNEL ?${notExistsCommand};`, name);
+        });
+    }
+    /**
+     * Deletes a Pub/Sub channel.
+     * @param name Channel name
+     */
+    removeChannel(name) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.connection.sql(`REMOVE CHANNEL ?;`, name);
         });
     }
     /**