node-firebird 2.0.0 → 2.0.1

package/0001-fix-attachEvent-host-resolution.patch

@@ -0,0 +1,72 @@
+From 0000000000000000000000000000000000000000 Mon Sep 17 00:00:00 2001
+From: Gobbo89 <gobbo89@users.noreply.github.com>
+Date: Thu, 19 Feb 2026 00:00:00 +0000
+Subject: [PATCH] fix(events): resolve event channel host from connection options
+
+When Firebird is configured with RemoteBindAddress unset (default),
+auxConnection() returns socket_info.host = "0.0.0.0", which is a
+bind-any address and not a routable destination for remote clients.
+
+This commit changes the host selection logic in attachEvent to prefer
+connection.options.host (the address that the user explicitly provided
+and that is proven reachable, since the initial DB attach succeeded).
+
+Only if options.host is absent does it fall back to socket_info.host,
+and even then only when that host is a concrete routable address (i.e.
+not "0.0.0.0" and not "::"). As a last resort it uses the socket's
+remoteAddress, normalizing IPv6-mapped IPv4 (::ffff:x.x.x.x → x.x.x.x).
+
+Fixes #386.
+
+---
+ lib/wire/database.js | 25 +++++++++++++++++++++++--
+ 1 file changed, 23 insertions(+), 2 deletions(-)
+
+diff --git a/lib/wire/database.js b/lib/wire/database.js
+index xxxxxxx..yyyyyyy 100644
+--- a/lib/wire/database.js
++++ b/lib/wire/database.js
+@@ -1,3 +1,18 @@
++/**
++ * Resolves the host to use for the auxiliary event channel.
++ *
++ * Priority:
++ *   1. connection.options.host  – explicitly provided by the caller; known reachable.
++ *   2. socket_info.host         – only when it is a concrete routable address
++ *                                 (i.e. not "0.0.0.0" and not "::").
++ *   3. socket.remoteAddress     – the OS-level address of the main connection socket,
++ *                                 with IPv6-mapped IPv4 prefixes stripped.
++ *
++ * @param {object} connection   The active database connection object.
++ * @param {string} auxHost      The host returned by the auxConnection() call.
++ * @returns {string}            A connectable host string.
++ */
++function resolveEventHost(connection, auxHost) {
++    // 1. Prefer the host the caller explicitly supplied.
++    if (connection.options && connection.options.host) {
++        return connection.options.host;
++    }
++
++    // 2. Use auxConnection host only when it is a real address.
++    var BIND_ANY = ['0.0.0.0', '::'];
++    if (auxHost && BIND_ANY.indexOf(auxHost) === -1) {
++        return auxHost;
++    }
++
++    // 3. Fall back to the OS-reported remote address of the main socket,
++    //    normalising IPv6-mapped IPv4 (e.g. "::ffff:10.0.0.1" → "10.0.0.1").
++    var remoteAddress = connection._socket && connection._socket.remoteAddress;
++    if (remoteAddress) {
++        return remoteAddress.replace(/^::ffff:/, '');
++    }
++
++    // Last resort: return whatever auxConnection gave us and let the caller fail
++    // with a meaningful socket error rather than a silent undefined.
++    return auxHost;
++}
++
+ // ... (existing code) ...
+ 
+-        var eventConnection = new EventConnection(socket_info.host, socket_info.port, self.connection.options, eventCallback);
++        var eventHost = resolveEventHost(self.connection, socket_info.host);
++        var eventConnection = new EventConnection(eventHost, socket_info.port, self.connection.options, eventCallback);

package/diff

@@ -0,0 +1,62 @@
+diff --git a/lib/wire/database.js b/lib/wire/database.js
+index d91b9db..a9f3128 100644
+--- a/lib/wire/database.js
++++ b/lib/wire/database.js
+@@ -5,6 +5,46 @@ const Const = require('./const');
+ const EventConnection = require('./eventConnection');
+ const FbEventManager = require('./fbEventManager');
+ 
++/**
++ * Resolves the host to use for the auxiliary event channel.
++ *
++ * Priority:
++ *   1. connection.options.host  – explicitly provided by the caller; known reachable.
++ *   2. socket_info.host         – only when it is a concrete routable address
++ *                                 (i.e. not "0.0.0.0" and not "::").
++ *   3. socket.remoteAddress     – the OS-level address of the main connection socket,
++ *                                 with IPv6-mapped IPv4 prefixes stripped.
++ *
++ * @param {object} connection   The active database connection object.
++ * @param {string} auxHost      The host returned by the auxConnection() call.
++ * @returns {string}            A connectable host string.
++ */
++function resolveEventHost(connection, auxHost) {
++    // 1. Prefer the host the caller explicitly supplied.
++    if (connection.options && connection.options.host) {
++        return connection.options.host;
++    }
++
++    // 2. Use auxConnection host only when it is a real address.
++    var BIND_ANY = ['0.0.0.0', '::'];
++    if (auxHost && BIND_ANY.indexOf(auxHost) === -1) {
++        return auxHost;
++    }
++
++    // 3. Fall back to the OS-reported remote address of the main socket,
++    //    normalising IPv6-mapped IPv4 (e.g. "::ffff:10.0.0.1" → "10.0.0.1").
++    var remoteAddress = connection._socket && connection._socket.remoteAddress;
++    if (remoteAddress) {
++        return remoteAddress.replace(/^::ffff:/, '');
++    }
++
++    // Last resort: return whatever auxConnection gave us and let the caller fail
++    // with a meaningful socket error rather than a silent undefined.
++    return auxHost;
++}
++
++
++
+ /***************************************
+  *
+  *   Database
+@@ -279,8 +319,9 @@ class Database extends Events.EventEmitter {
+                 doError(err, callback);
+                 return;
+             }
++            var eventHost = resolveEventHost(self.connection, socket_info.host);
+ 
+-            const eventConnection = new EventConnection(socket_info.host, socket_info.port, function (err) {
++            const eventConnection = new EventConnection(eventHost, socket_info.port, function (err) {
+                 if (err) {
+                     doError(err, callback);
+                     return;

package/lib/wire/database.js

@@ -280,7 +280,12 @@ class Database extends Events.EventEmitter {
                 return;
             }
 
-            const eventConnection = new EventConnection(socket_info.host, socket_info.port, function (err) {
+            const host = (socket_info.host === '0.0.0.0' || socket_info.host === '::')
+                ? self.connection.options.host
+                : socket_info.host;
+
+            const eventConnection = new EventConnection(
+                host, socket_info.port, function(err) {
                 if (err) {
                     doError(err, callback);
                     return;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "node-firebird",
-    "version": "2.0.0",
+    "version": "2.0.1",
     "description": "Pure JavaScript and Asynchronous Firebird client for Node.js.",
     "keywords": [
         "firebird",

package/srp.js

@@ -1,94 +0,0 @@
-const BigInteger = require('big-integer');
-const crypto = require('crypto');
-
-console.log('Preparing benchmark...');
-
-// Constants from lib/srp.js
-const HEX_N = 'E67D2E994B2F900C3F41F08F5BB2627ED0D49EE1FE767A52EFCD565CD6E768812C3E1E9CE8F0A8BEA6CB13CD29DDEBF7A96D4A93B55D488DF099A15C89DCB0640738EB2CBDD9A8F7BAB561AB1B0DC1C6CDABF303264A08D1BCA932D1F1EE428B619D970F342ABA9A65793B8B2F041AE5364350C16F735F56ECBCA87BD57B29E7';
-const DEC_K = '1277432915985975349439481660349303019122249719989';
-
-// --- Library Setup ---
-const lib_N = BigInteger(HEX_N, 16);
-const lib_g = BigInteger(2);
-const lib_k = BigInteger(DEC_K);
-
-// --- Native Setup ---
-const native_N = BigInt('0x' + HEX_N);
-const native_g = 2n;
-const native_k = BigInt(DEC_K);
-
-/**
- * Native BigInt Modular Exponentiation
- * Calculates (base ^ exp) % mod
- */
-function nativeModPow(base, exp, mod) {
-    let result = 1n;
-    base = base % mod;
-    while (exp > 0n) {
-        if (exp & 1n) result = (result * base) % mod;
-        base = (base * base) % mod;
-        exp >>= 1n;
-    }
-    return result;
-}
-
-// --- Test Data Generation ---
-const ITERATIONS = 2000;
-const inputs = [];
-
-for (let i = 0; i < ITERATIONS; i++) {
-    // Generate random 32-byte private key (similar to SRP_KEY_SIZE)
-    const hex = crypto.randomBytes(32).toString('hex');
-    inputs.push({
-        lib: BigInteger(hex, 16),
-        native: BigInt('0x' + hex)
-    });
-}
-
-// --- Verification ---
-console.log('Verifying implementations match...');
-const vLib = lib_g.modPow(inputs[0].lib, lib_N);
-const vNative = nativeModPow(native_g, inputs[0].native, native_N);
-
-if (vLib.toString(16) !== vNative.toString(16)) {
-    console.error('MISMATCH!');
-    console.error('Lib:', vLib.toString(16));
-    console.error('Nat:', vNative.toString(16));
-    process.exit(1);
-}
-console.log('Verification passed.');
-
-// --- Benchmark ---
-console.log(`\nStarting benchmark (${ITERATIONS} iterations)...`);
-
-// 1. Library Benchmark
-const startLib = process.hrtime.bigint();
-for (let i = 0; i < ITERATIONS; i++) {
-    // Simulate: A = g^a % N
-    const A = lib_g.modPow(inputs[i].lib, lib_N);
-    
-    // Simulate part of server calc: B = (k*v + g^b) % N
-    // We'll just do (k * A) % N + A to simulate the mix of mult/add/mod
-    const term = lib_k.multiply(A).mod(lib_N).add(A).mod(lib_N);
-}
-const endLib = process.hrtime.bigint();
-
-// 2. Native Benchmark
-const startNative = process.hrtime.bigint();
-for (let i = 0; i < ITERATIONS; i++) {
-    // Simulate: A = g^a % N
-    const A = nativeModPow(native_g, inputs[i].native, native_N);
-    
-    // Simulate part of server calc: B = (k*v + g^b) % N
-    const term = ((native_k * A) % native_N + A) % native_N;
-}
-const endNative = process.hrtime.bigint();
-
-// --- Results ---
-const timeLib = Number(endLib - startLib) / 1e6; // ms
-const timeNative = Number(endNative - startNative) / 1e6; // ms
-
-console.log('\nResults:');
-console.log(`big-integer (Lib): ${timeLib.toFixed(2)} ms`);
-console.log(`Native BigInt:     ${timeNative.toFixed(2)} ms`);
-console.log(`\nSpeedup: ${(timeLib / timeNative).toFixed(2)}x faster`);