node-firebird 2.5.0 → 2.7.0

package/lib/wire/connection.js

@@ -294,6 +294,42 @@ class Connection {
         msg.addBlr(pluginData); // Send the callback response data as a buffer
         this._socket.write(msg.getData());
     }
+    /**
+     * Send an out-of-band op_cancel packet (protocol 12+ / Firebird 2.5+).
+     * The server reads it asynchronously while an operation is executing and
+     * makes that operation fail with isc_cancelled (GDSCode.CANCELLED); the
+     * op_cancel packet itself has no response, so nothing is queued here.
+     */
+    cancelOperation(kind, callback) {
+        if (typeof kind === 'function') {
+            callback = kind;
+            kind = undefined;
+        }
+        kind = kind || const_1.default.fb_cancel_raise;
+        if (this._isClosed)
+            return this.throwClosed(callback);
+        if (!this.accept || this.accept.protocolVersion < const_1.default.PROTOCOL_VERSION12) {
+            (0, callback_1.doError)(new Error('Query cancellation requires protocol 12+ (Firebird 2.5 or newer)'), callback);
+            return;
+        }
+        var msg = this._msg;
+        msg.pos = 0;
+        msg.addInt(const_1.default.op_cancel);
+        msg.addInt(kind);
+        this._socket.write(msg.getData());
+        if (callback)
+            callback();
+    }
+    /** Write a prebuilt packet and queue its response callback. */
+    _queueEventBuffer(buffer, callback) {
+        if (this._isClosed) {
+            if (callback)
+                callback(new Error('Connection is closed.'));
+            return;
+        }
+        this._socket.write(buffer);
+        this._queue.push(callback);
+    }
     _queueEvent(callback, defer = false) {
         var self = this;
         if (self._isClosed) {
@@ -897,6 +933,187 @@ class Connection {
                 callback(err, ret);
         });
     }
+    /**
+     * Execute a statement once per row using the Firebird 4 batch API
+     * (protocol 16+): op_batch_create + op_batch_msg(s) + op_batch_exec +
+     * op_batch_rls, all pipelined in a single network flush. Every packet
+     * gets an in-order response (op_batch_cs for exec), so the regular
+     * response queue keeps everything in sync.
+     *
+     * rows: array of parameter arrays, one per record. BLOB/ARRAY columns
+     * are not supported yet. The callback receives a completion object:
+     * { recordCount, updateCounts, errors: [{recordNumber, error}],
+     *   errorRecordNumbers, success }.
+     */
+    executeBatch(transaction, statement, rows, callback, options) {
+        options = options || {};
+        if (this._isClosed)
+            return this.throwClosed(callback);
+        if (!this.accept || this.accept.protocolVersion < const_1.default.PROTOCOL_VERSION16) {
+            (0, callback_1.doError)(new Error('executeBatch requires protocol 16+ (Firebird 4.0 or newer)'), callback);
+            return;
+        }
+        var input = statement.input;
+        if (!input || !input.length) {
+            (0, callback_1.doError)(new Error('executeBatch requires a statement with input parameters'), callback);
+            return;
+        }
+        if (!Array.isArray(rows)) {
+            (0, callback_1.doError)(new Error('executeBatch expects an array of parameter rows'), callback);
+            return;
+        }
+        if (rows.length === 0) {
+            if (callback)
+                callback(undefined, {
+                    recordCount: 0, updateCounts: [], errors: [], errorRecordNumbers: [], success: true,
+                });
+            return;
+        }
+        for (var i = 0; i < rows.length; i++) {
+            if (!Array.isArray(rows[i]) || rows[i].length !== input.length) {
+                (0, callback_1.doError)(new Error('executeBatch row ' + i + ' must be an array of ' + input.length + ' values'), callback);
+                return;
+            }
+        }
+        var built;
+        try {
+            built = buildBatchEncoders(input, Object.assign({}, this.options, options));
+        }
+        catch (err) {
+            (0, callback_1.doError)(err, callback);
+            return;
+        }
+        var self = this;
+        var encoders = built.encoders;
+        var chunkSize = options.chunkSize > 0 ? options.chunkSize : 500;
+        var chunkCount = Math.ceil(rows.length / chunkSize);
+        var failure = null;
+        var completion = null;
+        var remaining = 2 + chunkCount; // create + msg chunks + exec
+        function settle(err) {
+            if (err && !failure)
+                failure = err;
+            remaining--;
+            if (remaining > 0)
+                return;
+            if (failure) {
+                (0, callback_1.doError)(failure, callback);
+                return;
+            }
+            var detailed = completion ? completion.detailedErrors : [];
+            var errorRecordNumbers = detailed.map(function (e) { return e.recordNumber; })
+                .concat(completion ? completion.errorRecordNumbers : []);
+            if (callback)
+                callback(undefined, {
+                    recordCount: completion ? completion.recordCount : 0,
+                    updateCounts: completion ? completion.updateCounts : [],
+                    errors: detailed,
+                    errorRecordNumbers: errorRecordNumbers,
+                    success: errorRecordNumbers.length === 0,
+                });
+        }
+        var msg = this._msg;
+        var blr = this._blr;
+        // Build every packet before writing anything: an encoding failure
+        // (e.g. an oversized CHAR/VARCHAR value) must abort the batch before
+        // a single byte hits the wire, or the response queue desyncs.
+        var packets = [];
+        try {
+            // 1. op_batch_create — the BLR is the statement's own described
+            // input format: the engine requires batch messages to match it
+            // exactly (a value-derived format is rejected with SQLDA errors).
+            msg.pos = 0;
+            blr.pos = 0;
+            CalcBlr(blr, input);
+            msg.addInt(const_1.default.op_batch_create);
+            msg.addInt(statement.handle);
+            msg.addBlr(blr);
+            msg.addInt(built.msglen);
+            var pb = buildBatchPb(options);
+            msg.addInt(pb.length);
+            msg.addParamBuffer(pb);
+            packets.push(Buffer.from(msg.getData()));
+            // 2. op_batch_msg — packed messages (null bitmap + non-null
+            // values), exactly the op_execute protocol-13 message encoding.
+            for (var c = 0; c < chunkCount; c++) {
+                var start = c * chunkSize;
+                var end = Math.min(start + chunkSize, rows.length);
+                msg.pos = 0;
+                msg.addInt(const_1.default.op_batch_msg);
+                msg.addInt(statement.handle);
+                msg.addInt(end - start);
+                for (var i = start; i < end; i++) {
+                    var row = rows[i];
+                    var nullBits = new serialize_1.BitSet();
+                    for (var j = 0; j < input.length; j++) {
+                        nullBits.set(j, row[j] === null || row[j] === undefined ? 1 : 0);
+                    }
+                    var nullBuffer = nullBits.toBuffer();
+                    var requireBytes = Math.floor((input.length + 7) / 8);
+                    var remainingBytes = requireBytes - nullBuffer.length;
+                    if (nullBuffer.length) {
+                        msg.addBuffer(nullBuffer);
+                    }
+                    if (remainingBytes > 0) {
+                        msg.addBuffer(Buffer.alloc(remainingBytes));
+                    }
+                    msg.addAlignment(requireBytes);
+                    for (var j = 0; j < input.length; j++) {
+                        if (row[j] !== null && row[j] !== undefined) {
+                            encoders[j](msg, row[j]);
+                        }
+                    }
+                }
+                packets.push(Buffer.from(msg.getData()));
+            }
+            // 3. op_batch_exec — answered with op_batch_cs.
+            msg.pos = 0;
+            msg.addInt(const_1.default.op_batch_exec);
+            msg.addInt(statement.handle);
+            msg.addInt(transaction.handle);
+            packets.push(Buffer.from(msg.getData()));
+            // 4. op_batch_rls — free the server-side batch.
+            msg.pos = 0;
+            msg.addInt(const_1.default.op_batch_rls);
+            msg.addInt(statement.handle);
+            packets.push(Buffer.from(msg.getData()));
+        }
+        catch (err) {
+            (0, callback_1.doError)(err, callback);
+            return;
+        }
+        // Pipeline everything: the server answers each packet in order
+        // (op_response for create/msg, op_batch_cs for exec), so one queued
+        // callback per packet keeps the response stream in sync. The server
+        // DEFERS the responses to create/msg/rls (PORT_lazy send_partial) —
+        // they only hit the wire when a flushing send occurs, which the
+        // op_batch_cs answer to exec provides. The rls response however is
+        // deferred past our last packet and arrives with the NEXT flushed
+        // response (commit, query, detach…), so completion must not wait
+        // for it: its queued callback is a no-op that just keeps the
+        // response stream aligned.
+        var execIndex = packets.length - 2;
+        for (var p = 0; p < packets.length; p++) {
+            this._pending.push('executeBatch');
+            if (p === execIndex) {
+                this._queueEventBuffer(packets[p], function (err, ret) {
+                    if (!err && ret && ret.batchCompletion) {
+                        completion = ret.batchCompletion;
+                        settle();
+                    }
+                    else {
+                        settle(err || new Error('op_batch_exec did not return a completion state'));
+                    }
+                });
+            }
+            else if (p === packets.length - 1) {
+                this._queueEventBuffer(packets[p], function () { });
+            }
+            else {
+                this._queueEventBuffer(packets[p], function (err) { settle(err); });
+            }
+        }
+    }
     executeStatement(transaction, statement, params, callback, custom) {
         if (this._isClosed)
             return this.throwClosed(callback);
@@ -1640,6 +1857,42 @@ function decodeResponse(data, callback, cnx, lowercase_keys, cb) {
                 };
                 // Parse normal and lazy response
                 return parseOpResponse(data, response, loop);
+            case const_1.default.op_batch_cs: {
+                // Batch completion state (response to op_batch_exec):
+                // statement, reccount, updates count, vectors count, errors
+                // count, then the update-count array, the (recnum + status
+                // vector) pairs and finally the status-less error recnums.
+                var completion = {
+                    statementHandle: data.readInt(),
+                    recordCount: data.readInt(),
+                };
+                var updatesCount = data.readInt();
+                var vectorsCount = data.readInt();
+                var simpleErrorsCount = data.readInt();
+                completion.updateCounts = new Array(updatesCount);
+                for (var bi = 0; bi < updatesCount; bi++) {
+                    completion.updateCounts[bi] = data.readInt();
+                }
+                completion.detailedErrors = [];
+                for (var bi = 0; bi < vectorsCount; bi++) {
+                    var recordNumber = data.readInt();
+                    var vector = readStatusVector(data);
+                    var recordError = new Error((0, utils_1.lookupMessages)(vector.status) || 'Batch record failed');
+                    if (vector.status.length) {
+                        recordError.gdscode = vector.status[0].gdscode;
+                        recordError.gdsparams = vector.status[0].params;
+                    }
+                    if (vector.sqlcode !== undefined) {
+                        recordError.sqlcode = vector.sqlcode;
+                    }
+                    completion.detailedErrors.push({ recordNumber: recordNumber, error: recordError });
+                }
+                completion.errorRecordNumbers = [];
+                for (var bi = 0; bi < simpleErrorsCount; bi++) {
+                    completion.errorRecordNumbers.push(data.readInt());
+                }
+                return cb(null, { batchCompletion: completion });
+            }
             case const_1.default.op_fetch_response:
             case const_1.default.op_sql_response:
                 var statement = callback.statement;
@@ -2054,6 +2307,44 @@ function decodeResponse(data, callback, cnx, lowercase_keys, cb) {
         throw err;
     }
 }
+/**
+ * Read one XDR status vector (as in op_response / op_batch_cs error
+ * vectors): a stream of isc_arg_* items terminated by isc_arg_end.
+ */
+function readStatusVector(data) {
+    var result = { status: [] };
+    var item = {};
+    while (true) {
+        var op = data.readInt();
+        switch (op) {
+            case const_1.default.isc_arg_end:
+                return result;
+            case const_1.default.isc_arg_gds:
+                var num = data.readInt();
+                if (!num) {
+                    break;
+                }
+                item = { gdscode: num };
+                result.status.push(item);
+                break;
+            case const_1.default.isc_arg_string:
+            case const_1.default.isc_arg_interpreted:
+            case const_1.default.isc_arg_sql_state:
+                var str = data.readString(const_1.default.DEFAULT_ENCODING);
+                (item.params = item.params || []).push(str);
+                break;
+            case const_1.default.isc_arg_number:
+                var n = data.readInt();
+                (item.params = item.params || []).push(n);
+                if (item.gdscode === const_1.default.isc_sqlerr) {
+                    result.sqlcode = n;
+                }
+                break;
+            default:
+                throw new Error('Unexpected status vector item: ' + op);
+        }
+    }
+}
 function parseOpResponse(data, response, cb) {
     var handle = data.readInt();
     if (!response.handle) {
@@ -2290,6 +2581,202 @@ function describe(buff, statement) {
     unpackCharSetCollation(statement.input);
     unpackCharSetCollation(statement.output);
 }
+/**
+ * Batch support: the engine requires every batch message to use EXACTLY the
+ * statement's described input format (unlike op_execute, where the client
+ * may declare its own format and the server converts). The BLR is therefore
+ * CalcBlr(statement.input), and this helper returns one value encoder per
+ * column that writes the wire representation mirroring the corresponding
+ * SQLVar* decode, including scale. Returns { encoders, msglen } where
+ * encoders[j](msg, value) writes a non-null value and msglen is the
+ * unpacked message length sent with op_batch_create.
+ */
+function buildBatchEncoders(input, options) {
+    var encoders = [];
+    var offset = 0;
+    var align = function (a) { offset = (offset + a - 1) & ~(a - 1); };
+    var jsonAsObject = options && options.jsonAsObject;
+    var toText = function (v) {
+        if (typeof v === 'string')
+            return v;
+        if (v instanceof Date)
+            return v.toString();
+        if (typeof v === 'object' && !Buffer.isBuffer(v))
+            return jsonAsObject ? JSON.stringify(v) : v.toString();
+        return String(v);
+    };
+    var toBytes = function (v, meta, column) {
+        var b = Buffer.isBuffer(v) ? v : Buffer.from(toText(v), const_1.default.DEFAULT_ENCODING);
+        if (b.length > meta.length) {
+            throw new Error('Batch value for column ' + column + ' is ' + b.length +
+                ' bytes but the column accepts at most ' + meta.length + ' (' + (meta.field || '?') + ')');
+        }
+        return b;
+    };
+    var toDate = function (v) {
+        if (v instanceof Date)
+            return v;
+        if (typeof v === 'string')
+            return (0, utils_1.parseDate)(v);
+        return new Date(v);
+    };
+    var scaled = function (v, scale) {
+        var n = typeof v === 'string' ? parseFloat(v) : Number(v);
+        return scale ? Math.round(n * Math.pow(10, -scale)) : n;
+    };
+    var scaledBig = function (v, scale) {
+        if (typeof v === 'bigint') {
+            return scale ? v * (10n ** BigInt(-scale)) : v;
+        }
+        return BigInt(scaled(v, scale));
+    };
+    for (var j = 0; j < input.length; j++) {
+        var meta = input[j];
+        var column = j + 1;
+        switch (meta.type) {
+            case const_1.default.SQL_TEXT: // CHAR: fixed meta.length bytes, space-padded
+                encoders.push((function (m, col) {
+                    return function (msg, v) {
+                        var b = toBytes(v, m, col);
+                        if (b.length < m.length) {
+                            b = Buffer.concat([b, Buffer.alloc(m.length - b.length, 0x20)]);
+                        }
+                        msg.addParamBuffer(b);
+                    };
+                })(meta, column));
+                offset += meta.length;
+                break;
+            case const_1.default.SQL_VARYING:
+            case const_1.default.SQL_NULL:
+                encoders.push((function (m, col) {
+                    return function (msg, v) {
+                        var b = toBytes(v, m, col);
+                        msg.addInt(b.length);
+                        msg.addParamBuffer(b);
+                    };
+                })(meta, column));
+                align(2);
+                offset += 2 + meta.length;
+                break;
+            case const_1.default.SQL_SHORT:
+                // 2 bytes in the message struct (msglen), 4 on the XDR wire
+                encoders.push((function (m) {
+                    return function (msg, v) { msg.addInt(scaled(v, m.scale)); };
+                })(meta));
+                align(2);
+                offset += 2;
+                break;
+            case const_1.default.SQL_LONG:
+                encoders.push((function (m) {
+                    return function (msg, v) { msg.addInt(scaled(v, m.scale)); };
+                })(meta));
+                align(4);
+                offset += 4;
+                break;
+            case const_1.default.SQL_INT64:
+                encoders.push((function (m) {
+                    return function (msg, v) {
+                        msg.addInt64(typeof v === 'bigint' ? scaledBig(v, m.scale) : scaled(v, m.scale));
+                    };
+                })(meta));
+                align(8);
+                offset += 8;
+                break;
+            case const_1.default.SQL_INT128:
+                encoders.push((function (m) {
+                    return function (msg, v) { msg.addInt128(scaledBig(v, m.scale)); };
+                })(meta));
+                align(8);
+                offset += 16;
+                break;
+            case const_1.default.SQL_FLOAT:
+            case const_1.default.SQL_D_FLOAT:
+                encoders.push(function (msg, v) { msg.addFloat(Number(v)); });
+                align(4);
+                offset += 4;
+                break;
+            case const_1.default.SQL_DOUBLE:
+                encoders.push(function (msg, v) { msg.addDouble(Number(v)); });
+                align(8);
+                offset += 8;
+                break;
+            case const_1.default.SQL_DEC16:
+                encoders.push(function (msg, v) { msg.addDecFloat16(v); });
+                align(8);
+                offset += 8;
+                break;
+            case const_1.default.SQL_DEC34:
+                encoders.push(function (msg, v) { msg.addDecFloat34(v); });
+                align(8);
+                offset += 16;
+                break;
+            case const_1.default.SQL_BOOLEAN:
+                // xdr_datum sends booleans as a 1-byte opaque (value byte
+                // first, then 3 pad bytes), not as a big-endian int.
+                encoders.push(function (msg, v) {
+                    msg.addBuffer(Buffer.from([v ? 1 : 0]));
+                    msg.addAlignment(1);
+                });
+                offset += 1;
+                break;
+            case const_1.default.SQL_TIMESTAMP:
+                encoders.push(function (msg, v) {
+                    var parts = Xsql.encodeDateTimeParts(toDate(v));
+                    msg.addInt(parts.date);
+                    msg.addUInt(parts.time);
+                });
+                align(4);
+                offset += 8;
+                break;
+            case const_1.default.SQL_TYPE_DATE:
+                encoders.push(function (msg, v) {
+                    msg.addInt(Xsql.encodeDateTimeParts(toDate(v)).date);
+                });
+                align(4);
+                offset += 4;
+                break;
+            case const_1.default.SQL_TYPE_TIME:
+                encoders.push(function (msg, v) {
+                    msg.addUInt(Xsql.encodeDateTimeParts(toDate(v)).time);
+                });
+                align(4);
+                offset += 4;
+                break;
+            default:
+                throw new Error('executeBatch does not support the type of parameter ' + column +
+                    ' yet (' + (meta.field || '?') + ', SQL type ' + meta.type + ')');
+        }
+        // null indicator short that CalcBlr appends per parameter
+        align(2);
+        offset += 2;
+    }
+    // msglen must EXACTLY match the length the server computes from the BLR
+    // (MsgMetadata::makeOffsets — no trailing alignment), or op_batch_create
+    // fails with -804 SQLDA errors.
+    return { encoders: encoders, msglen: offset };
+}
+/**
+ * Build the batch parameter buffer (p_batch_pb): a wide-tagged clumplet
+ * buffer — version byte, then per clumplet a tag byte, int32 LE length and
+ * the value (ints are 4-byte LE).
+ */
+function buildBatchPb(options) {
+    var parts = [const_1.default.BATCH_VERSION1];
+    var addIntClumplet = function (tag, value) {
+        parts.push(tag, 4, 0, 0, 0, value & 0xFF, (value >> 8) & 0xFF, (value >> 16) & 0xFF, (value >> 24) & 0xFF);
+    };
+    addIntClumplet(const_1.default.BATCH_TAG_RECORD_COUNTS, 1);
+    if (!options || options.multiError !== false) {
+        addIntClumplet(const_1.default.BATCH_TAG_MULTIERROR, 1);
+    }
+    if (options && options.bufferSize) {
+        addIntClumplet(const_1.default.BATCH_TAG_BUFFER_BYTES_SIZE, options.bufferSize);
+    }
+    if (options && options.detailedErrors !== undefined) {
+        addIntClumplet(const_1.default.BATCH_TAG_DETAILED_ERRORS, options.detailedErrors);
+    }
+    return Buffer.from(parts);
+}
 function CalcBlr(blr, xsqlda) {
     blr.addBytes([const_1.default.blr_version5, const_1.default.blr_begin, const_1.default.blr_message, 0]); // + message number
     blr.addWord(xsqlda.length * 2);

package/lib/wire/const.d.ts

@@ -98,12 +98,31 @@ declare const Const: Readonly<{
     op_crypt: number;
     op_crypt_key_callback: number;
     op_cond_accept: number;
+    op_batch_create: number;
+    op_batch_msg: number;
+    op_batch_exec: number;
+    op_batch_rls: number;
+    op_batch_cs: number;
+    op_batch_cancel: number;
+    op_batch_sync: number;
+    op_info_batch: number;
     op_fetch_scroll: number;
     op_info_cursor: number;
     op_inline_blob: number;
     DSQL_close: number;
     DSQL_drop: number;
     DSQL_unprepare: number;
+    BATCH_VERSION1: number;
+    BATCH_TAG_MULTIERROR: number;
+    BATCH_TAG_RECORD_COUNTS: number;
+    BATCH_TAG_BUFFER_BYTES_SIZE: number;
+    BATCH_TAG_BLOB_POLICY: number;
+    BATCH_TAG_DETAILED_ERRORS: number;
+    BATCH_BLOB_NONE: number;
+    fb_cancel_disable: number;
+    fb_cancel_enable: number;
+    fb_cancel_raise: number;
+    fb_cancel_abort: number;
     fetch_next: number;
     fetch_prior: number;
     fetch_first: number;

package/lib/wire/const.js

@@ -108,6 +108,14 @@ const op = {
     op_crypt_key_callback: 97,
     op_cond_accept: 98, // Server accepts connection, returns some data to client
     // and asks client to continue authentication before attach call
+    op_batch_create: 99, // Create a statement batch (protocol 16+)
+    op_batch_msg: 100, // Add a bunch of messages to the batch
+    op_batch_exec: 101, // Execute the batch; server answers with op_batch_cs
+    op_batch_rls: 102, // Release the batch
+    op_batch_cs: 103, // Batch completion state (response to op_batch_exec)
+    op_batch_cancel: 109, // Cancel the batch
+    op_batch_sync: 110, // Wait for batch processing
+    op_info_batch: 111,
     op_fetch_scroll: 112,
     op_info_cursor: 113,
     op_inline_blob: 114,
@@ -117,6 +125,25 @@ const dsql = {
     DSQL_drop: 2,
     DSQL_unprepare: 4, // >: 2.5
 };
+// Batch parameter buffer (op_batch_create p_batch_pb) — a wide-tagged
+// clumplet buffer: version byte, then per clumplet a tag byte, an int32 LE
+// length and the value bytes. Tags from Firebird's IBatch interface.
+const batch = {
+    BATCH_VERSION1: 1,
+    BATCH_TAG_MULTIERROR: 1, // continue after per-record errors
+    BATCH_TAG_RECORD_COUNTS: 2, // return per-record update counts
+    BATCH_TAG_BUFFER_BYTES_SIZE: 3, // server-side batch buffer limit
+    BATCH_TAG_BLOB_POLICY: 4,
+    BATCH_TAG_DETAILED_ERRORS: 5, // max detailed status vectors returned
+    BATCH_BLOB_NONE: 0,
+};
+// fb_cancel_operation kinds sent with op_cancel (protocol 12+ / Firebird 2.5+)
+const cancelKind = {
+    fb_cancel_disable: 1, // disable execution of fb_cancel_raise requests
+    fb_cancel_enable: 2, // re-enable delivery of cancel requests
+    fb_cancel_raise: 3, // cancel the operation currently executing on the attachment
+    fb_cancel_abort: 4, // forcibly abort the attachment's current activity
+};
 const fetchOp = {
     fetch_next: 0,
     fetch_prior: 1,
@@ -793,7 +820,9 @@ const Const = Object.freeze({
     ...authOptions,
     ...blr,
     ...blobType,
+    ...batch,
     ...buffer,
+    ...cancelKind,
     ...cnct,
     ...common,
     ...connect,

package/lib/wire/database.d.ts

@@ -9,9 +9,27 @@ declare class Database extends Events.EventEmitter {
     startTransaction(options: any, callback?: (err: any, transaction?: any) => void): this;
     newStatement(query: string, callback: (err: any, statement?: any) => void): this;
     execute(query: string, params?: any, callback?: any, options?: any): this;
+    /**
+     * Bulk-execute `query` once per row via the Firebird 4 batch API
+     * (protocol 16+) with all-or-nothing semantics: the batch runs in its
+     * own transaction, committed only when every record succeeded and
+     * rolled back otherwise. On failure the error of the first failed
+     * record is reported, with the full completion attached as
+     * err.batchCompletion. Use transaction.executeBatch for partial-success
+     * handling.
+     */
+    executeBatch(query: string, rows: any[][], callback?: any, options?: any): this;
     sequentially(query: string, params?: any, on?: any, callback?: any, options?: any): this;
     query(query: string, params?: any, callback?: any, options?: any): this;
     drop(callback?: (err?: any) => void): void;
+    /**
+     * Cancel the operation currently executing on this connection by sending
+     * an out-of-band op_cancel (Firebird 2.5+ / protocol 12+). The cancelled
+     * operation fails through its own callback with err.gdscode ===
+     * GDSCode.CANCELLED. `kind` defaults to fb_cancel_raise; cancellation is
+     * per-attachment, not per-statement.
+     */
+    cancel(kind?: number | ((err?: any) => void), callback?: (err?: any) => void): this;
     attachEvent(callback: (err: any, evt?: any) => void): this;
     /**
      * Create a physical tablespace.
@@ -55,6 +73,7 @@ declare class Database extends Events.EventEmitter {
     createSchema(schemaName: string, tablespaceName?: string | ((err?: any) => void), callback?: any): this;
     queryAsync(query: string, params?: any, options?: any): Promise<any[]>;
     executeAsync(query: string, params?: any, options?: any): Promise<any[]>;
+    executeBatchAsync(query: string, rows: any[][], options?: any): Promise<any>;
     sequentiallyAsync(query: string, params?: any, on?: any, options?: any): Promise<void>;
     transactionAsync(options?: any): Promise<any>;
     startTransactionAsync(options?: any): Promise<any>;
@@ -62,6 +81,7 @@ declare class Database extends Events.EventEmitter {
     detachAsync(force?: boolean): Promise<void>;
     dropAsync(): Promise<void>;
     attachEventAsync(): Promise<any>;
+    cancelAsync(kind?: number): Promise<void>;
     /**
      * Run `work` inside a transaction: commits when the returned promise
      * resolves, rolls back when it rejects (the original error is rethrown,