@memberjunction/global 6.2.0-edge.2 → 6.2.0-edge.4

package/README.md

@@ -515,6 +515,32 @@ IsValueEncrypted('plain text');                                    // false
 IsEncryptedSentinel('[!ENCRYPTED$]');                              // true
 ```
 
+### Binary Encoding
+
+Above the database, MemberJunction represents a binary column (`varbinary` / `binary` / `image`, PostgreSQL `bytea`) as a **base64 string** — in `BaseEntity` fields, caches, `RunView` rows and GraphQL alike. These helpers convert and validate it. The codec is picked once per process from the fastest the host offers (native `Uint8Array.fromBase64`/`toBase64`, Node `Buffer`, then `atob`/`btoa`); every codec accepts and produces the same strings. See the [Binary Fields Guide](../../guides/BINARY_FIELDS_GUIDE.md).
+
+| Function | Description |
+|---|---|
+| `BytesToBase64(bytes)` | Bytes to standard, padded base64 |
+| `Base64ToBytes(b64)` | Base64 to bytes; throws on invalid input |
+| `TryBase64ToBytes(b64)` | Same, but returns `null` for null/undefined or invalid input |
+| `IsValidBase64(value)` | Canonical base64 only: standard alphabet, optional padding, no whitespace, data-URI prefix or URL-safe alphabet |
+| `HasValidBase64Shape(value)` | Length/padding shape check only |
+| `Base64DecodedByteLength(b64)` | Decoded byte count without decoding (for size checks) |
+| `IsByteArray(value)` | True for a `Uint8Array` (including a Node `Buffer`) |
+| `ReplaceByteArraysWithBase64(row)` | Replaces top-level byte arrays in a row with base64; copy-on-write, never mutates the input |
+| `Float32VectorToBytes(values)` / `BytesToFloat32Vector(bytes)` | A vector as little-endian float32 bytes (4 per value, no header); decode returns `null` for empty or misaligned input |
+| `Float32VectorToBase64(values)` / `Base64ToFloat32Vector(b64)` | The same, as the base64 value stored in a binary vector field such as `VectorBinary` |
+| `GetBase64Codec()` / `Base64Codecs` | The codec in use / every available codec (diagnostics and tests) |
+
+```typescript
+import { Float32VectorToBase64, Base64ToFloat32Vector, TryBase64ToBytes } from '@memberjunction/global';
+
+doc.VectorBinary = Float32VectorToBase64(embedding);        // write
+const vector = Base64ToFloat32Vector(doc.VectorBinary);     // Float32Array | null
+const bytes = TryBase64ToBytes(file.Content);               // Uint8Array | null
+```
+
 ### String and JSON Utilities
 
 A collection of utility functions for common string and JSON operations.

package/dist/__tests__/BinaryEncoding.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=BinaryEncoding.test.d.ts.map

package/dist/__tests__/BinaryEncoding.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BinaryEncoding.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/BinaryEncoding.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/BinaryEncoding.test.js

@@ -0,0 +1,244 @@
+import { describe, it, expect, afterEach } from 'vitest';
+import { BINARY_CHANGE_VALUE_PREFIX, FormatBinaryChangeValue, IsBinaryChangeValue, Base64Codecs, Base64ToBytes, Base64ToFloat32Vector, BytesToBase64, BytesToFloat32Vector, Float32VectorCodecs, Float32VectorToBase64, Float32VectorToBytes, GetBase64Codec, IsByteArray, IsValidBase64, TryBase64ToBytes, } from '../util/BinaryEncoding.js';
+/** Deterministic pseudo-random bytes, so failures reproduce. */
+function bytesOf(length, seed = 7) {
+    const out = new Uint8Array(length);
+    let s = seed;
+    for (let i = 0; i < length; i++) {
+        s = (s * 16807) % 2147483647;
+        out[i] = s & 0xff;
+    }
+    return out;
+}
+const [nativeCodec, nodeCodec, portableCodec] = Base64Codecs;
+/**
+ * Installs a stand-in for the TC39 `Uint8Array.fromBase64` / `toBase64` API (absent in Node 22)
+ * that records how it was called, so the native implementation can be exercised.
+ */
+function installNativeBase64() {
+    const calls = [];
+    const statics = Uint8Array;
+    const proto = Uint8Array.prototype;
+    statics.fromBase64 = (input, options) => {
+        calls.push(`fromBase64:${options?.lastChunkHandling ?? 'none'}`);
+        return new Uint8Array(Buffer.from(input, 'base64'));
+    };
+    proto.toBase64 = function () {
+        calls.push('toBase64');
+        return Buffer.from(this.buffer, this.byteOffset, this.byteLength).toString('base64');
+    };
+    return {
+        calls,
+        restore: () => {
+            delete statics.fromBase64;
+            delete proto.toBase64;
+        },
+    };
+}
+describe('IsValidBase64', () => {
+    it.each(['', 'AA==', 'AAA=', 'AAAA', 'AAAAAA', 'AQID', '+/+/', 'aGVsbG8='])('accepts %j', value => {
+        expect(IsValidBase64(value)).toBe(true);
+    });
+    it.each([
+        ['a single dangling character', 'A'],
+        ['five characters (one dangling)', 'AAAAA'],
+        ['whitespace', 'AA AA'],
+        ['a line break', 'AAAA\nAAAA'],
+        ['the URL-safe alphabet', 'AA-_'],
+        ['a data URI', 'data:image/png;base64,AAAA'],
+        ['padding before the end', 'AA=A'],
+        ['three padding characters', 'A==='],
+        ['padding on a partial quantum', 'AAAAA='],
+        ['non-ASCII', 'AAÀA'],
+    ])('rejects %s', (_label, value) => {
+        expect(IsValidBase64(value)).toBe(false);
+    });
+});
+describe('base64 implementations', () => {
+    afterEach(() => {
+        // Defensive: a failed test must not leave the stand-in installed for the next one.
+        delete Uint8Array.fromBase64;
+        delete Uint8Array.prototype.toBase64;
+    });
+    it('lists the native API first, then Node Buffer, then atob/btoa', () => {
+        expect(Base64Codecs.map(c => c.Name)).toEqual([
+            'Uint8Array.fromBase64 / toBase64',
+            'Node Buffer',
+            'atob / btoa',
+        ]);
+    });
+    it('detects the native API by duck typing', () => {
+        expect(nativeCodec.IsAvailable()).toBe(false); // Node 22 has no Uint8Array.fromBase64
+        const native = installNativeBase64();
+        expect(nativeCodec.IsAvailable()).toBe(true);
+        native.restore();
+        expect(nativeCodec.IsAvailable()).toBe(false);
+    });
+    it('selects Node Buffer on Node, and keeps that choice for the life of the process', () => {
+        expect(GetBase64Codec()).toBe(nodeCodec);
+        const native = installNativeBase64();
+        expect(GetBase64Codec()).toBe(nodeCodec); // selection is cached, not re-evaluated
+        native.restore();
+    });
+    it('calls the native API with loose final-chunk handling, so unpadded input decodes', () => {
+        const native = installNativeBase64();
+        expect(Array.from(nativeCodec.Decode('AQI'))).toEqual([1, 2]);
+        expect(nativeCodec.Encode(new Uint8Array([1, 2]))).toBe('AQI=');
+        expect(native.calls).toEqual(['fromBase64:loose', 'toBase64']);
+        native.restore();
+    });
+    it.each([0, 1, 2, 3, 4, 5, 255, 256, 1536 * 4, 0x8000 - 1, 0x8000, 0x8000 + 1, 200_000])('produces identical strings and bytes in every implementation for %i bytes', length => {
+        const native = installNativeBase64();
+        const bytes = bytesOf(length, length + 1);
+        const expected = Buffer.from(bytes).toString('base64');
+        for (const codec of Base64Codecs) {
+            expect(codec.Encode(bytes), codec.Name).toBe(expected);
+            expect(Array.from(codec.Decode(expected)), codec.Name).toEqual(Array.from(bytes));
+        }
+        native.restore();
+    });
+    it('encodes only the viewed range of a subarray in every implementation', () => {
+        const native = installNativeBase64();
+        const backing = bytesOf(64);
+        const view = backing.subarray(5, 21);
+        const expected = Buffer.from(view).toString('base64');
+        for (const codec of Base64Codecs)
+            expect(codec.Encode(view), codec.Name).toBe(expected);
+        native.restore();
+    });
+    it('returns bytes that own their buffer from the Node implementation, never a pooled view', () => {
+        const decoded = nodeCodec.Decode('AQID');
+        expect(decoded.byteOffset).toBe(0);
+        expect(decoded.buffer.byteLength).toBe(3);
+        expect(Buffer.isBuffer(decoded)).toBe(false);
+    });
+    it('reports the portable implementation as available wherever atob and btoa exist', () => {
+        expect(portableCodec.IsAvailable()).toBe(true);
+    });
+});
+describe('BytesToBase64 / Base64ToBytes', () => {
+    it('round-trips every byte value', () => {
+        const all = new Uint8Array(256).map((_, i) => i);
+        expect(Array.from(Base64ToBytes(BytesToBase64(all)))).toEqual(Array.from(all));
+    });
+    it('maps zero bytes to the empty string and back', () => {
+        expect(BytesToBase64(new Uint8Array(0))).toBe('');
+        expect(Base64ToBytes('').length).toBe(0);
+    });
+    it('accepts a Node Buffer as input', () => {
+        expect(BytesToBase64(Buffer.from([1, 2, 3]))).toBe('AQID');
+    });
+    it('decodes unpadded input the same as padded input', () => {
+        expect(Array.from(Base64ToBytes('AQI'))).toEqual(Array.from(Base64ToBytes('AQI=')));
+    });
+    it('throws on invalid input instead of guessing, unlike a lenient Buffer.from', () => {
+        expect(Buffer.from('AA AA', 'base64').length).toBeGreaterThan(0); // Node alone would accept this
+        expect(() => Base64ToBytes('AA AA')).toThrow('Invalid base64 value (length 5)');
+        expect(() => Base64ToBytes('A')).toThrow('Invalid base64');
+    });
+    it('returns null from TryBase64ToBytes for missing or invalid input', () => {
+        expect(TryBase64ToBytes(null)).toBeNull();
+        expect(TryBase64ToBytes(undefined)).toBeNull();
+        expect(TryBase64ToBytes('not base64!')).toBeNull();
+        expect(TryBase64ToBytes('')?.length).toBe(0);
+        expect(Array.from(TryBase64ToBytes('AQID') ?? [])).toEqual([1, 2, 3]);
+    });
+});
+describe('IsByteArray', () => {
+    it('recognises Uint8Array and Node Buffer, and nothing else', () => {
+        expect(IsByteArray(new Uint8Array(1))).toBe(true);
+        expect(IsByteArray(Buffer.from('x'))).toBe(true);
+        expect(IsByteArray('AQID')).toBe(false);
+        expect(IsByteArray(new Uint16Array(1))).toBe(false);
+        expect(IsByteArray(new ArrayBuffer(4))).toBe(false);
+        expect(IsByteArray(null)).toBe(false);
+        expect(IsByteArray({ type: 'Buffer', data: [1] })).toBe(false);
+    });
+});
+describe('float32 vectors', () => {
+    const sample = [0, 1, -1, 0.5, -2.25, 3.4028234663852886e38, 1e-45, Math.PI];
+    it('writes little-endian IEEE-754 single precision, 4 bytes per value, no header', () => {
+        const bytes = Float32VectorToBytes([1, -2]);
+        // 1.0f = 0x3F800000, -2.0f = 0xC0000000, least significant byte first
+        expect(Array.from(bytes)).toEqual([0x00, 0x00, 0x80, 0x3f, 0x00, 0x00, 0x00, 0xc0]);
+    });
+    it('produces identical bytes and values in both implementations', () => {
+        const [typedArray, dataView] = Float32VectorCodecs;
+        const expected = typedArray.Encode(sample);
+        expect(Array.from(dataView.Encode(sample))).toEqual(Array.from(expected));
+        expect(Array.from(dataView.Decode(expected))).toEqual(Array.from(typedArray.Decode(expected)));
+    });
+    it('round-trips through bytes and through base64, rounding to single precision', () => {
+        const expected = Array.from(Float32Array.from(sample));
+        expect(Array.from(BytesToFloat32Vector(Float32VectorToBytes(sample)) ?? [])).toEqual(expected);
+        expect(Array.from(Base64ToFloat32Vector(Float32VectorToBase64(sample)) ?? [])).toEqual(expected);
+        expect(Base64ToFloat32Vector(Float32VectorToBase64([0.1]))?.[0]).toBe(Math.fround(0.1));
+    });
+    it('accepts a Float32Array as input', () => {
+        const source = Float32Array.from([1.5, 2.5]);
+        expect(Array.from(BytesToFloat32Vector(Float32VectorToBytes(source)) ?? [])).toEqual([1.5, 2.5]);
+    });
+    it('preserves NaN and infinities, leaving validation to the caller', () => {
+        const decoded = Base64ToFloat32Vector(Float32VectorToBase64([NaN, Infinity, -Infinity]));
+        expect(Number.isNaN(decoded?.[0])).toBe(true);
+        expect(decoded?.[1]).toBe(Infinity);
+        expect(decoded?.[2]).toBe(-Infinity);
+    });
+    it('decodes from a misaligned view, such as a pooled Node Buffer, in both implementations', () => {
+        const encoded = Float32VectorToBytes([1, 2, 3]);
+        const backing = new Uint8Array(encoded.length + 1);
+        backing.set(encoded, 1);
+        const misaligned = backing.subarray(1); // byteOffset 1: a Float32Array view over it would throw
+        for (const codec of Float32VectorCodecs) {
+            expect(Array.from(codec.Decode(misaligned)), codec.Name).toEqual([1, 2, 3]);
+        }
+        expect(Array.from(BytesToFloat32Vector(misaligned) ?? [])).toEqual([1, 2, 3]);
+    });
+    it('returns a vector that owns its memory, so later writes to the source do not leak in', () => {
+        const bytes = Float32VectorToBytes([1, 2]);
+        const decoded = BytesToFloat32Vector(bytes);
+        bytes.fill(0);
+        expect(Array.from(decoded ?? [])).toEqual([1, 2]);
+    });
+    it.each([
+        ['null', null],
+        ['undefined', undefined],
+        ['zero bytes', new Uint8Array(0)],
+        ['6 bytes (not a whole number of values)', new Uint8Array(6)],
+        ['1 byte', new Uint8Array(1)],
+    ])('returns null for %s', (_label, bytes) => {
+        expect(BytesToFloat32Vector(bytes)).toBeNull();
+    });
+    it('returns null for a missing, invalid or truncated base64 vector', () => {
+        expect(Base64ToFloat32Vector(null)).toBeNull();
+        expect(Base64ToFloat32Vector('')).toBeNull();
+        expect(Base64ToFloat32Vector('%%%%')).toBeNull();
+        expect(Base64ToFloat32Vector(Buffer.from([1, 2, 3, 4, 5, 6]).toString('base64'))).toBeNull();
+    });
+    it('encodes an empty vector as zero bytes', () => {
+        expect(Float32VectorToBytes([]).length).toBe(0);
+        expect(Float32VectorToBase64([])).toBe('');
+    });
+});
+describe('FormatBinaryChangeValue / IsBinaryChangeValue (change-log text for a binary value)', () => {
+    it('reports the decoded size with a thousands separator, never the content', () => {
+        expect(FormatBinaryChangeValue('AQID')).toBe('[binary: 3 bytes]');
+        expect(FormatBinaryChangeValue('AQIDBA==')).toBe('[binary: 4 bytes]');
+        expect(FormatBinaryChangeValue('A'.repeat(8192))).toBe('[binary: 6,144 bytes]');
+        expect(FormatBinaryChangeValue('')).toBe('[binary: 0 bytes]');
+    });
+    it('reports invalid base64 as such instead of throwing', () => {
+        expect(FormatBinaryChangeValue('not base64!')).toBe('[binary: invalid base64]');
+        expect(FormatBinaryChangeValue('data:image/png;base64,AAAA')).toBe('[binary: invalid base64]');
+    });
+    it('recognises its own output and nothing else', () => {
+        expect(IsBinaryChangeValue(FormatBinaryChangeValue('AQID'))).toBe(true);
+        expect(IsBinaryChangeValue('[binary: invalid base64]')).toBe(true);
+        expect(IsBinaryChangeValue('AQID')).toBe(false);
+        expect(IsBinaryChangeValue('[binary')).toBe(false);
+        expect(IsBinaryChangeValue(null)).toBe(false);
+        expect(IsBinaryChangeValue(42)).toBe(false);
+        expect(FormatBinaryChangeValue('AQID').startsWith(BINARY_CHANGE_VALUE_PREFIX)).toBe(true);
+    });
+});
+//# sourceMappingURL=BinaryEncoding.test.js.map

package/dist/__tests__/BinaryEncoding.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BinaryEncoding.test.js","sourceRoot":"","sources":["../../src/__tests__/BinaryEncoding.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/BinaryEncodingRows.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=BinaryEncodingRows.test.d.ts.map

package/dist/__tests__/BinaryEncodingRows.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BinaryEncodingRows.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/BinaryEncodingRows.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/BinaryEncodingRows.test.js

@@ -0,0 +1,146 @@
+import { describe, it, expect, afterEach, vi } from 'vitest';
+import { Base64DecodedByteLength, Base64ToBytes, BytesToBase64, Float32VectorCodecs, FLOAT32_VECTOR_BYTES_PER_VALUE, ReplaceByteArraysWithBase64, } from '../util/BinaryEncoding.js';
+describe('Base64DecodedByteLength', () => {
+    it.each([
+        ['', 0],
+        ['AA==', 1],
+        ['AAA=', 2],
+        ['AAAA', 3],
+        ['AQID', 3],
+        ['AAAAAA==', 4],
+        ['aGVsbG8=', 5],
+    ])('reports %j as %i bytes', (value, expected) => {
+        expect(Base64DecodedByteLength(value)).toBe(expected);
+    });
+    it.each([
+        ['AA', 1],
+        ['AAA', 2],
+        ['AQI', 2],
+        ['AAAAAA', 4],
+    ])('handles unpadded %j as %i bytes', (value, expected) => {
+        expect(Base64DecodedByteLength(value)).toBe(expected);
+    });
+    it('agrees with the actual decoded length for every size 0..64, padded and unpadded', () => {
+        for (let length = 0; length <= 64; length++) {
+            const bytes = new Uint8Array(length).map((_, i) => (i * 31) & 0xff);
+            const padded = BytesToBase64(bytes);
+            const unpadded = padded.replace(/=+$/, '');
+            expect(Base64DecodedByteLength(padded), `padded ${length}`).toBe(length);
+            expect(Base64DecodedByteLength(unpadded), `unpadded ${length}`).toBe(length);
+            expect(Base64ToBytes(unpadded).length).toBe(length);
+        }
+    });
+    it('agrees with the decoded length of a large value without decoding it', () => {
+        const bytes = new Uint8Array(100_001);
+        expect(Base64DecodedByteLength(BytesToBase64(bytes))).toBe(100_001);
+    });
+});
+describe('ReplaceByteArraysWithBase64', () => {
+    it('returns the same object when the row has no byte arrays', () => {
+        const row = { ID: 'a', Name: 'x', Count: 3, Data: 'AQID', Missing: null, Nested: { inner: new Uint8Array([1]) } };
+        expect(ReplaceByteArraysWithBase64(row)).toBe(row);
+    });
+    it('returns the same object for an empty row', () => {
+        const row = {};
+        expect(ReplaceByteArraysWithBase64(row)).toBe(row);
+    });
+    it('replaces a Uint8Array value with base64 in a shallow copy', () => {
+        const bytes = new Uint8Array([1, 2, 3]);
+        const row = { ID: 'a', Data: bytes };
+        const result = ReplaceByteArraysWithBase64(row);
+        expect(result).not.toBe(row);
+        expect(result).toEqual({ ID: 'a', Data: 'AQID' });
+        expect(row.Data).toBe(bytes); // input untouched
+    });
+    it('replaces a Node Buffer value', () => {
+        const row = { Data: Buffer.from([1, 2, 3]) };
+        expect(ReplaceByteArraysWithBase64(row)).toEqual({ Data: 'AQID' });
+    });
+    it('replaces every byte array, copying only once, and keeps other values by reference', () => {
+        const nested = { a: 1 };
+        const row = {
+            First: new Uint8Array([255]),
+            Text: 'hello',
+            Nested: nested,
+            Second: Buffer.from([0, 0, 0]),
+            Empty: new Uint8Array(0),
+        };
+        const result = ReplaceByteArraysWithBase64(row);
+        expect(result).toEqual({ First: '/w==', Text: 'hello', Nested: nested, Second: 'AAAA', Empty: '' });
+        expect(result.Nested).toBe(nested);
+        expect(IsUint8(row.First)).toBe(true);
+        expect(IsUint8(row.Second)).toBe(true);
+    });
+    it('does not convert other typed arrays or ArrayBuffers', () => {
+        const u16 = new Uint16Array([1]);
+        const ab = new ArrayBuffer(2);
+        const row = { A: u16, B: ab };
+        expect(ReplaceByteArraysWithBase64(row)).toBe(row);
+    });
+    it('never mutates a frozen cache entry', () => {
+        const row = Object.freeze({ ID: 'x', Data: new Uint8Array([1, 2]) });
+        const result = ReplaceByteArraysWithBase64(row);
+        expect(result).toEqual({ ID: 'x', Data: 'AQI=' });
+        expect(Object.isFrozen(row)).toBe(true);
+        expect(row.Data).toBeInstanceOf(Uint8Array);
+        expect(Object.isFrozen(result)).toBe(false);
+    });
+    it('encodes only the viewed range of a subarray value', () => {
+        const backing = new Uint8Array([9, 1, 2, 3, 9]);
+        const row = { Data: backing.subarray(1, 4) };
+        expect(ReplaceByteArraysWithBase64(row).Data).toBe('AQID');
+    });
+    it('produces a value that survives JSON serialization as a string', () => {
+        const row = { Data: Buffer.from('hi') };
+        expect(JSON.parse(JSON.stringify(ReplaceByteArraysWithBase64(row)))).toEqual({ Data: 'aGk=' });
+    });
+});
+function IsUint8(value) {
+    return value instanceof Uint8Array;
+}
+describe('float32 vector codecs', () => {
+    it('uses 4 bytes per value', () => {
+        expect(FLOAT32_VECTOR_BYTES_PER_VALUE).toBe(4);
+    });
+    it('DataView implementation writes little-endian bytes explicitly', () => {
+        const dataView = Float32VectorCodecs[1];
+        expect(dataView.Name).toBe('DataView (any host)');
+        expect(Array.from(dataView.Encode([1, -2]))).toEqual([0x00, 0x00, 0x80, 0x3f, 0x00, 0x00, 0x00, 0xc0]);
+        expect(Array.from(dataView.Encode([]))).toEqual([]);
+    });
+    it('both implementations decode an empty-but-aligned buffer to an empty vector', () => {
+        for (const codec of Float32VectorCodecs) {
+            expect(codec.Decode(new Uint8Array(0)).length, codec.Name).toBe(0);
+        }
+    });
+});
+describe('GetBase64Codec selection on a bare host', () => {
+    afterEach(() => {
+        vi.unstubAllGlobals();
+        vi.resetModules();
+    });
+    it('falls back to atob/btoa when Buffer is absent', async () => {
+        vi.stubGlobal('Buffer', undefined);
+        vi.resetModules();
+        // A fresh module instance is needed because the codec choice is cached per process.
+        const fresh = await import('../util/BinaryEncoding.js');
+        expect(fresh.GetBase64Codec().Name).toBe('atob / btoa');
+        expect(fresh.BytesToBase64(new Uint8Array([1, 2, 3]))).toBe('AQID');
+        expect(Array.from(fresh.Base64ToBytes('AQI'))).toEqual([1, 2]);
+        expect(fresh.ReplaceByteArraysWithBase64({ D: new Uint8Array([255]) })).toEqual({ D: '/w==' });
+    });
+    it('throws when the host offers no base64 implementation', async () => {
+        vi.stubGlobal('Buffer', undefined);
+        vi.stubGlobal('atob', undefined);
+        vi.stubGlobal('btoa', undefined);
+        vi.resetModules();
+        const fresh = await import('../util/BinaryEncoding.js');
+        expect(() => fresh.GetBase64Codec()).toThrow('No base64 implementation is available on this host');
+        expect(() => fresh.BytesToBase64(new Uint8Array([1]))).toThrow('No base64 implementation');
+        // Zero bytes and invalid input never reach a codec.
+        expect(fresh.BytesToBase64(new Uint8Array(0))).toBe('');
+        expect(fresh.Base64ToBytes('').length).toBe(0);
+        expect(fresh.TryBase64ToBytes('!!')).toBeNull();
+    });
+});
+//# sourceMappingURL=BinaryEncodingRows.test.js.map

package/dist/__tests__/BinaryEncodingRows.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BinaryEncodingRows.test.js","sourceRoot":"","sources":["../../src/__tests__/BinaryEncodingRows.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/BinaryEncodingValidation.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=BinaryEncodingValidation.test.d.ts.map

package/dist/__tests__/BinaryEncodingValidation.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BinaryEncodingValidation.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/BinaryEncodingValidation.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/BinaryEncodingValidation.test.js

@@ -0,0 +1,98 @@
+import { describe, it, expect } from 'vitest';
+import { Base64Codecs, BytesToBase64, HasValidBase64Shape, IsValidBase64 } from '../util/BinaryEncoding.js';
+/**
+ * Strict validation is enforced twice: by `IsValidBase64` (a character scan, used by codecs without a
+ * fused decoder) and by the Node codec's `TryDecode` (decode, then compare lengths — about five times
+ * cheaper). The two must agree on EVERY input, or the same value would be accepted on one host and
+ * refused on another. These tests pin that agreement, mostly by fuzzing.
+ */
+const nodeCodec = Base64Codecs.find(c => c.Name === 'Node Buffer');
+if (!nodeCodec?.TryDecode)
+    throw new Error('the Node Buffer codec must expose TryDecode');
+const tryDecode = (value) => nodeCodec.TryDecode(value);
+/** Deterministic PRNG so a failing fuzz case reproduces. */
+function mulberry32(seed) {
+    let a = seed;
+    return () => {
+        a = (a + 0x6d2b79f5) | 0;
+        let t = Math.imul(a ^ (a >>> 15), 1 | a);
+        t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
+        return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+    };
+}
+const ALPHABET = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';
+/** Characters a corrupted or foreign value might contain — URL-safe, whitespace, punctuation, non-ASCII. */
+const HOSTILE = ['=', '-', '_', ' ', '\n', '\t', '\r', '.', '!', '*', '"', '\\', 'é', '€', '\u0000', '😀'];
+describe('base64 validation: Node fused decode agrees with IsValidBase64', () => {
+    it.each([
+        ['', true],
+        ['AA==', true],
+        ['AAA=', true],
+        ['AAAA', true],
+        ['AAAAAA', true],
+        ['AAAAAAA', true],
+        ['A', false],
+        ['A===', false],
+        ['AA=', false],
+        ['=AAA', false],
+        ['AA==AAAA', false],
+        ['AA-A', false],
+        ['AA_A', false],
+        ['AA A', false],
+        ['AA\nA', false],
+        ['AAAA\n', false],
+        ['AAéA', false],
+        ['data:AAAA', false],
+    ])('%j → %s', (value, expected) => {
+        expect(IsValidBase64(value)).toBe(expected);
+        expect(tryDecode(value) !== null).toBe(expected);
+    });
+    it('decodes valid input to the same bytes the input encoded', () => {
+        const rand = mulberry32(7);
+        for (let n = 0; n < 300; n++) {
+            const bytes = Uint8Array.from({ length: n }, () => Math.floor(rand() * 256));
+            const encoded = BytesToBase64(bytes);
+            expect(Array.from(tryDecode(encoded) ?? [])).toEqual(Array.from(bytes));
+            expect(Array.from(tryDecode(encoded.replace(/=+$/, '')) ?? [])).toEqual(Array.from(bytes)); // unpadded
+        }
+    });
+    it('agrees on 20,000 random strings mixing valid and hostile characters', () => {
+        const rand = mulberry32(42);
+        let accepted = 0;
+        for (let n = 0; n < 20000; n++) {
+            const length = Math.floor(rand() * 24);
+            let value = '';
+            for (let i = 0; i < length; i++) {
+                value += rand() < 0.9 ? ALPHABET[Math.floor(rand() * ALPHABET.length)] : HOSTILE[Math.floor(rand() * HOSTILE.length)];
+            }
+            if (rand() < 0.3)
+                value += rand() < 0.5 ? '=' : '==';
+            const strict = IsValidBase64(value);
+            if (strict)
+                accepted++;
+            expect({ value, fused: tryDecode(value) !== null }).toEqual({ value, fused: strict });
+        }
+        expect(accepted).toBeGreaterThan(1000); // the corpus exercises the accept path too
+    });
+    it('agrees when one character of a valid string is corrupted, at every position', () => {
+        const encoded = BytesToBase64(Uint8Array.from({ length: 30 }, (_, i) => (i * 37) & 0xff));
+        for (let i = 0; i < encoded.length; i++) {
+            for (const bad of HOSTILE) {
+                const value = encoded.slice(0, i) + bad + encoded.slice(i + 1);
+                expect({ value, fused: tryDecode(value) !== null }).toEqual({ value, fused: IsValidBase64(value) });
+            }
+        }
+    });
+});
+describe('HasValidBase64Shape', () => {
+    it.each([
+        ['', true], ['AA', true], ['AAA', true], ['AAAA', true], ['AA==', true], ['AAA=', true],
+        ['A', false], ['AAAAA', false], ['AA=', false], ['A=', false],
+    ])('%j → %s (length and padding only, characters ignored)', (value, expected) => {
+        expect(HasValidBase64Shape(value)).toBe(expected);
+    });
+    it('does not inspect characters', () => {
+        expect(HasValidBase64Shape('!!!!')).toBe(true);
+    });
+});
+//# sourceMappingURL=BinaryEncodingValidation.test.js.map

package/dist/__tests__/BinaryEncodingValidation.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BinaryEncodingValidation.test.js","sourceRoot":"","sources":["../../src/__tests__/BinaryEncodingValidation.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/UUIDCollections.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=UUIDCollections.test.d.ts.map

package/dist/__tests__/UUIDCollections.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UUIDCollections.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/UUIDCollections.test.ts"],"names":[],"mappings":""}