Implement IEEE 754-2008 DECFLOAT support for Firebird 4.0+ Protocol 16/17

[Copilot]

Adds Protocol 16/17 support with full IEEE 754-2008 Decimal64/Decimal128 implementation following Jaybird's BID (Binary Integer Decimal) approach.

Protocol Support

• Protocol 16 (Firebird 4.0) and Protocol 17 (Firebird 5.0) constants
• Automatic protocol negotiation with backward compatibility (FB 2.5, 3.0, 4.0, 5.0)
• Extended metadata identifiers (63 characters)

IEEE 754 DECFLOAT Implementation

New module: lib/ieee754-decimal.js (470 lines)

• Native BigInt implementation, zero dependencies
• BID format encoding/decoding for both Decimal64 and Decimal128
• Proper bit-level operations for combination field, exponent, coefficient

Decimal64 (DECFLOAT(16)):

• 16-digit precision, 8-byte encoding
• Exponent range: -383 to +384
• Bit layout: 1 sign + 5 combo + 8 exponent + 50 coefficient

Decimal128 (DECFLOAT(34)):

• 34-digit precision, 16-byte encoding
• Exponent range: -6143 to +6144
• Bit layout: 1 sign + 5 combo + 12 exponent + 110 coefficient

Special values: NaN, ±Infinity, ±0

Integration

Updated lib/wire/serialize.js:

// XdrWriter
addDecFloat16(value) {
    const buffer = encodeDecimal64(value);
    this.addBlr(buffer);
}

// XdrReader  
readDecFloat16() {
    const buffer = this.readBuffer(8);
    return decodeDecimal64(buffer);
}

Works with existing SQLVarDecFloat16/34 and SQLParamDecFloat16/34 classes in lib/wire/xsqlvar.js.

Testing

76 DECFLOAT tests in test/decfloat.js:

• Basic operations (encoding, decoding, round-trip)
• Special values and edge cases
• Precision validation (max digits, exponent ranges)
• Error handling (out of range, invalid input)
• Wire protocol integration

All tests passing. Integration tests requiring Firebird server show expected failures (no server in test environment).

Technical Details

Combination field encoding (5 bits):

• Bits 4-3: Exponent top 2 bits
• Bits 2-0: MSD (most significant digit 0-9)
• Special patterns for MSD 8-9 and special values

Coefficient reconstruction:

• Decimal64: MSD × 10^15 + coeffCont (50-bit continuation)
• Decimal128: MSD × 10^33 + coeffCont (110-bit continuation)

Matches Jaybird's decimal-java implementation strategy without external dependencies.

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.